Fehler und Limits

Die Form eines Fehlers

Jede Antwort hat ein Feld ok. Wird eine Anfrage abgelehnt, ist ok gleich false, und error ist ein Satz, der sagt, was schiefgegangen ist und was Sie dagegen tun können. Er ist so geschrieben, dass er einer Person unverändert angezeigt werden kann.

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

Eine Ablehnung hat keine weiteren Felder, mit einer Ausnahme: Eine Änderung, die gestartet wurde und dann mangels Credits nicht ausgeführt werden konnte, enthält zusätzlich outOfCredits: true.

Statuscodes

Aus Datenschutzgründen geben „keine solche App“ und „eine App, die Sie nicht nutzen dürfen“ dasselbe 404 zurück. Sonst ließe sich mit einem Schlüssel herausfinden, welche Apps existieren. Das gilt auch für eine App, die Sie nur ansehen dürfen, wenn der Aufruf einen Editor verlangt.

Wer was tun darf

Ihre Rolle in der App entscheidet, welche Aufrufe funktionieren:

Limits

Die stündlichen Limits sind ein Tempo, kein Kontingent. Sie sind für ein Skript da, das schneller läuft, als eine Person es kann, und wer von Hand arbeitet, erreicht sie nie. Was Sie in der Praxis begrenzt, sind Ihre Credits.

Änderungen sind außerdem durch Ihre Credits und Ihren Tarif begrenzt, genau wie im Editor. Kann eine Änderung aus diesem Grund nicht ausgeführt werden, lautet die Antwort 200 mit ok: false und einem error, der den Grund nennt. Bei der Store-Seite ist es anders: Wenn sie abgelehnt wird, hat sie noch nicht begonnen, deshalb antwortet sie mit 402.

Welches Limit wie antwortet

• Publish antwortet mit 429, wenn die 100 des Tages aufgebraucht sind, und mit 503, wenn der Limiter selbst nicht erreichbar ist.
• Store-Seite antwortet mit 429 für das Stundenlimit, mit 503, wenn der Limiter nicht erreichbar ist, und mit 402 für Tarif und Credits.
• Änderung antwortet mit 200 und ok: false, und error enthält den Satz. Der stündliche lautet You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.