How recipes work

Some websites tell Diazoma how to show their lists. Most do not. For those, a recipe says where the items, links and pictures are on the page.

What a recipe is

A recipe is a small JSON file. It names the sites it applies to and gives a selector or a path for each field. It holds no code, so it cannot do anything except read the page it was written for.

How a recipe gets listed

Every recipe ships with saved copies of real pages. Before it is listed, those pages are replayed through the same reader your headset uses, and each page must give items with a link and a picture. Listed recipes appear in signed lists that your headset checks before it uses them.

What happens when a site changes

Headsets send counts of pages read and pages that gave no items, with no addresses and no personal data. If too many pages come back empty, the recipe is marked degraded and a repair is prepared from a fresh copy of the page. A repaired version is never listed on its own. A person approves it, or it must show a full day of healthy numbers first.

Using the catalog from your own code

The same information is available as JSON. Start with the API description, or read the documentation.

curl "https://diazoma.app/v1/recipes?match=https://commons.wikimedia.org"

Missing a site? Request a recipe.