API pessoal
Erros
Os códigos de resposta e o que fazer com cada um.
Todo erro volta em JSON, com uma mensagem em português que pode ser mostrada para a pessoa:
{ "error": "Este token só pode ler este cofre." }| Código | Quando acontece | O que fazer |
|---|---|---|
400 | Faltou um campo ou o formato está errado | Corrija o pedido. A mensagem diz o quê. |
401 | Token ausente, mal formado, inválido, revogado ou vencido | Peça um token novo à pessoa. Não tente de novo com o mesmo. |
403 | Sem permissão para o cofre, a agenda ou os anexos; conta diferente da informada em X-Paper-Account; modo desenvolvedor desligado; conta banida | Não insista. Avise a pessoa do que falta. |
404 | Cofre ou página não encontrados | Confira os ids com GET /vaults e GET /vaults/{cofre}/pages. Cofres precisam estar sincronizados com o Google Drive. |
409 | O Google ou a agenda não foram liberados para a API, ou a pessoa revogou o acesso no Google | A pessoa precisa abrir o app e liberar de novo em Configurações → Desenvolvedor. |
413 | Arquivo ou texto grande demais | Divida ou reduza. Veja Limites. |
423 | Página protegida por senha | Deixe a página em paz. Nenhum token abre. |
429 | Limite de pedidos ou de envios | Espere e tente de novo, com intervalos crescentes. |
500 | Erro do nosso lado | Tente de novo em alguns minutos. Se repetir, avise o suporte. |
502 | O Google Drive ou o Google Agenda falharam | Tente de novo mais tarde. |
503 | Serviço em manutenção | Tente de novo mais tarde. |
Tentar de novo
Só vale tentar de novo em 429, 500, 502 e 503. Use intervalos crescentes e um teto de tentativas. Os outros códigos não mudam sozinhos.