# Erros

Fonte: https://wire.ia.br/documentation/api/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:

```json
{ "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](/api/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](https://wire.ia.br/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 [#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.