POST /v1/harness/read

Lire une source

Une adresse, un markdown ou un texte : la recette qu’il contient, dans la forme que validate lit.

POSThttps://api.rikaido.app/v1/harness/read

La requête

sourcestring · requis

Une adresse web, du markdown ou le texte d’une recette. Au plus 60 000 caractères.

locale'fr' | 'en'

La langue de la source, pour le copiste. fr par défaut.

Comment c’est lu

La recette est d’abord localisée, dans les mots de la source — jamais paraphrasée avant d’être jugée :

markup — le balisage schema.org de la page, quand elle en a un. Rien n’est deviné.
as-written — le texte tel qu’écrit, quand il est titré en ingrédients et en étapes.
transcribed — le modèle, en copiste, sous un vérificateur de fidélité, en dernier recours.

Puis chaque ligne d’ingrédient est mise en forme en { name, quantity, unit } par un lecteur vérifié. Une ligne qu’il ne sait pas lire arrive entière dans name, sans quantité, et read.unread les compte.

La réponse

200

{
  "recipe": {
    "title": "Focaccia aux tomates cerises",
    "servings": 6,
    "ingredients": [{ "name": "farine tout usage", "quantity": "500", "unit": "g" }],
    "steps": [{ "instruction": "Mélanger la farine, l’eau, la levure et le sel." }]
  },
  "read": { "how": "markup", "url": "https://…", "site": "example.com" }
}

Envoie recipe tel quel à validate : c’est la même forme.

Les erreurs

Code	`code`	Quand
`400`	`empty`	La source est vide.
`413`	`too-large`	Plus de 60 000 caractères.
`422`	`no-recipe`	Rien qui ressemble à une recette dans la source.
`4xx`	`private-address`, `unreachable`, `not-a-page`	L’adresse pointe vers un réseau privé, ne répond pas, ou n’est pas une page.
`429`		Plus de 10 lectures dans la minute.

Ce que ça coûte

0,050 $ l’appel. Une lecture va chercher une page et peut appeler le modèle ; le prix suit le coût. Rien n’est gardé.