Paper documentação
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ódigoQuando aconteceO que fazer
400Faltou um campo ou o formato está erradoCorrija o pedido. A mensagem diz o quê.
401Token ausente, mal formado, inválido, revogado ou vencidoPeça um token novo à pessoa. Não tente de novo com o mesmo.
403Sem permissão para o cofre, a agenda ou os anexos; conta diferente da informada em X-Paper-Account; modo desenvolvedor desligado; conta banidaNão insista. Avise a pessoa do que falta.
404Cofre ou página não encontradosConfira os ids com GET /vaults e GET /vaults/{cofre}/pages. Cofres precisam estar sincronizados com o Google Drive.
409O Google ou a agenda não foram liberados para a API, ou a pessoa revogou o acesso no GoogleA pessoa precisa abrir o app e liberar de novo em Configurações → Desenvolvedor.
413Arquivo ou texto grande demaisDivida ou reduza. Veja Limites.
423Página protegida por senhaDeixe a página em paz. Nenhum token abre.
429Limite de pedidos ou de enviosEspere e tente de novo, com intervalos crescentes.
500Erro do nosso ladoTente de novo em alguns minutos. Se repetir, avise o suporte.
502O Google Drive ou o Google Agenda falharamTente de novo mais tarde.
503Serviço em manutençãoTente 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.

Nesta página