> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watahub.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Erros e novas tentativas

> Diferencie os contratos de erro antes de tentar novamente.

A API `/v1` pode retornar `GatewayError`, `ValidationError` ou `MetaError`. Rotas compatíveis com Graph podem retornar o corpo `GraphError` e status originais da Meta. Não use um único parser para ambas as interfaces.

Status comuns: `401` para chaves inválidas, `402` para pagamento, `404` para recursos inexistentes ou de outra conta, `409` para conflitos, `422` para validação do core, `429` para limites e `503` para gateway pausado ou sem configuração. Confira a referência de cada operação.

## Evite duplicados

`unknown_outcome` significa que o envio pode ter ocorrido. Consulte eventos e histórico antes de tentar novamente. Um timeout ou erro do servidor não prova que nada aconteceu.

Em `429`, respeite `Retry-After` quando presente. Limite tentativas e aumente os intervalos gradualmente; não presuma uma cota universal.

## Diagnostique com segurança

`GET /v1/logs` filtra `origin` (`api`, `meta`, `webhook`) e erros (`errors=1` ou `errors=true`). O contrato descreve até 200 entradas por sete dias; corpos não são registrados.

Em um `500` com `requestId`, informe esse ID ao suporte, não chaves ou mensagens dos clientes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.