/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.