RÉFÉRENCE
Erreurs et limites
Ce que l’API répond quand elle ne répond pas oui, et à quelle vitesse tu peux l’appeler.
La forme d’une erreur
Toujours du JSON, toujours une phrase, souvent un code :
402
{
"error": "This month's free calls are used. Add a card at developer.rikaido.app to keep calling.",
"code": "payment-required"
}| Statut | code | Quoi faire |
|---|---|---|
400 | Le corps ne tient pas. La phrase dit quel champ. | |
401 | invalid-key | La clé est inconnue, mal formée ou révoquée. Une clé de session (pas rk_live_) passe par l’app, pas ici. |
402 | payment-required | Les appels offerts du mois sont utilisés. Ajoute une carte dans la console. |
413 | too-large | La source dépasse 60 000 caractères. |
422 | no-recipe | Rien à lire. |
429 | Ralentis ; la limite est par compte, par minute. | |
503 | auth_unavailable, usage-unavailable | Le magasin de clés ou d’usage n’a pas répondu. Réessaie ; l’appel n’a pas été compté. |
Les limites
| Route | Par minute |
|---|---|
POST /v1/harness/validate | 60 |
POST /v1/harness/read | 10 |
Les limites sont par compte, toutes clés confondues. Une réponse 429 n’est pas comptée.
Ce qui n’est jamais deviné
Un 503 sur la lecture de tes contraintes ou de ton usage refuse l’appel plutôt que de répondre avec un contrôle qui n’a pas tourné. Une réponse propre sur une vérification qui n’a pas eu lieu est la seule chose qu’un harnais ne doit jamais rendre.