Błędy i limity

Kształt błędu

Każda odpowiedź ma pole ok. Gdy żądanie zostaje odrzucone, ok ma wartość false, a error to zdanie, które mówi, co poszło nie tak i co z tym zrobić. Jest napisane tak, żeby pokazać je człowiekowi bez zmian.

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

Odmowa nie ma innych pól, z jednym wyjątkiem: edycja, która się rozpoczęła, a potem nie mogła działać z braku kredytów, niesie też outOfCredits: true.

Kody statusu

Ze względu na prywatność „nie ma takiej aplikacji” i „aplikacja, której nie możesz użyć” dają ten sam 404. W przeciwnym razie klucz mógłby posłużyć do sprawdzania, jakie aplikacje istnieją. Dotyczy to także aplikacji, którą możesz tylko oglądać, gdy wywołanie wymaga edytora.

Kto co może

O tym, które wywołania działają, decyduje twoja rola w aplikacji:

Limity

Limity godzinowe to tempo, a nie przydział. Są po to, by zatrzymać skrypt działający szybciej, niż potrafi człowiek, i nikt, kto pracuje ręcznie, ich nie osiąga. W praktyce ogranicza cię liczba kredytów.

Edycje są też ograniczone twoimi kredytami i twoim planem, dokładnie tak jak w edytorze. Gdy edycja nie może działać z tego powodu, odpowiedzią jest 200 z ok: false i error, który mówi dlaczego. Strona sklepowa jest inna: gdy zostaje odrzucona, nie wystartowała jeszcze, więc odpowiada 402.

Który limit odpowiada jak

• Publikowanie odpowiada 429, gdy 100 z danego dnia jest wykorzystane, i 503, gdy sam ogranicznik jest nieosiągalny.
• Strona sklepowa odpowiada 429 przy limicie godzinowym, 503, gdy ogranicznik jest nieosiągalny, i 402 przy planie i kredytach.
• Edycja odpowiada 200 z ok: false, a error niesie zdanie. Godzinowe brzmi tak: You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.