Errori e limiti

La forma di un errore

Ogni risposta ha un campo ok. Quando una richiesta viene rifiutata, ok è false ed error è una frase che dice cosa è andato storto e cosa fare. È scritta per essere mostrata a una persona così com’è.

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

Un rifiuto non ha altri campi, con un’eccezione: una modifica che è partita e poi non ha potuto proseguire per mancanza di crediti porta anche outOfCredits: true.

Codici di stato

Per riservatezza, “nessuna app di questo tipo” e “un’app che non puoi usare” danno lo stesso 404. Altrimenti una chiave potrebbe servire a scoprire quali app esistono. Questo vale anche per un’app che puoi solo visualizzare quando la chiamata richiede un Editor.

Chi può fare cosa

Il tuo ruolo sull’app decide quali chiamate funzionano:

Limiti

I limiti orari sono un ritmo, non una quota. Ci sono per uno script che va più veloce di una persona, e nessuno che lavora a mano li raggiunge. Ciò che ti limita in pratica sono i tuoi crediti.

Le modifiche sono limitate anche dai tuoi crediti e dal tuo piano, esattamente come nell’editor. Quando una modifica non può partire per questo motivo, la risposta è 200 con ok: false e un error che ne dice il motivo. La scheda dello store è diversa: quando viene rifiutata non è ancora partita, quindi risponde 402.

Quale limite risponde come

• Publish risponde 429 quando le 100 del giorno sono esaurite, e 503 quando il limitatore stesso non è raggiungibile.
• Scheda dello store risponde 429 per il limite dell’ora, 503 quando il limitatore non è raggiungibile e 402 per piano e crediti.
• Edit risponde 200 con ok: false, e error porta la frase. Quella oraria dice You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.