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/push/test POST
Pushes a test notification in the current user's language to one of their subscriptions, which is 404 otherwise. At most one every 10 seconds per subscription, 429 otherwise.
/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.