Erreurs et limites

La forme d’une erreur

Chaque réponse a un champ ok. Quand une requête est refusée, ok vaut false et error est une phrase qui dit ce qui s’est mal passé et que faire. Elle est écrite pour être montrée telle quelle à une personne.

{ "ok": false, "error": "No such app on this account." }

Un refus n’a pas d’autres champs, à une exception près : une modification qui a commencé puis n’a pas pu s’exécuter faute de crédits porte aussi outOfCredits: true.

Codes de statut

Par souci de confidentialité, « pas une telle application » et « une application que vous n’avez pas le droit d’utiliser » donnent le même 404. Sinon, une clé pourrait servir à découvrir quelles applications existent. Cela inclut une application que vous pouvez seulement consulter quand l’appel exige un éditeur.

Qui peut faire quoi

Votre rôle sur l’application décide quels appels fonctionnent :

Limites

Les limites horaires sont un rythme, pas une allocation. Elles sont là pour un script qui s’exécute plus vite qu’une personne ne le peut, et personne qui travaille à la main ne les atteint. Ce qui vous limite en pratique, ce sont vos crédits.

Les modifications sont aussi limitées par vos crédits et par votre forfait, exactement comme dans l’éditeur. Quand une modification ne peut pas s’exécuter pour cette raison, la réponse est 200 avec ok: false et un error qui dit pourquoi. La fiche du store est différente : elle n’a pas encore commencé quand elle est refusée, donc elle répond 402.

Quelle limite répond comment

• La publication répond 429 quand les 100 du jour sont utilisées, et 503 quand le limiteur lui-même est injoignable.
• La fiche du store répond 429 pour la limite de l’heure, 503 quand le limiteur est injoignable, et 402 pour le forfait et les crédits.
• La modification répond 200 avec ok: false, et error porte la phrase. Celle de la limite horaire est You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.