Rezepte
ReferenceShares

Shares

Public links to recipes: creating, listing and revoking them. Session only.

Create a public link to a recipe

Opens a link anyone can read the recipe by without signing in, until it is revoked or expires. A caller who already has one for the recipe gets it back with a 409.

List public links

The caller's own public links, newest first. With all=true, an admin gets everyone's, each with its creator.

Revoke every public link

Every public link in the household, whoever created it. Admins only.

Get the caller's public link to a recipe

200 with share: null when the caller has no live public link for this recipe, or the recipe is unknown - not an error, so a page can call this on every view.

Revoke a public link

The caller's own link, or anyone's as an admin. The link stops working at once.

/api/v1/import POST

Import recipes from an export zip (at most 1 GiB)

/api/v1/recipes/{id}/public-share POST

Opens a link anyone can read the recipe by without signing in, until it is revoked or expires. A caller who already has one for the recipe gets it back with a 409.