Erros e limites

O formato de um erro

Toda resposta tem um campo ok. Quando uma solicitação é recusada, ok é false e error é uma frase que diz o que deu errado e o que fazer a respeito. Ela é escrita para ser mostrada a uma pessoa do jeito que está.

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

Não há outros campos em uma recusa, com uma exceção: uma edição que começou e depois não pôde continuar por falta de créditos também traz outOfCredits: true.

Códigos de status

Por privacidade, “não existe esse app” e “um app que você não pode usar” dão o mesmo 404. Caso contrário, uma chave poderia ser usada para descobrir quais apps existem. Isso inclui um app que você só pode ver quando a chamada exige um editor.

Quem pode fazer o quê

A sua função no app decide quais chamadas funcionam:

Limites

Os limites por hora são um ritmo, não uma cota. Eles existem para um script que roda mais rápido do que uma pessoa consegue, e ninguém que trabalha à mão chega a eles. O que limita você na prática são os seus créditos.

As edições também são limitadas pelos seus créditos e pelo seu plano, exatamente como no editor. Quando uma edição não pode ser executada por esse motivo, a resposta é 200 com ok: false e um error que diz por quê. A página da loja é diferente: ela ainda não começou quando é recusada, então responde 402.

Qual limite responde como

• Publicar responde 429 quando as 100 do dia foram usadas, e 503 quando o próprio limitador não pode ser alcançado.
• Página da loja responde 429 para o limite da hora, 503 quando o limitador não pode ser alcançado, e 402 para plano e créditos.
• Editar responde 200 com ok: false, e error traz a frase. A do limite por hora diz You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.