API pública

Diagnosticar 401, 403, 422 e 429

401 quer dizer que a chave não foi aceita de jeito nenhum. 403 quer dizer que foi aceita mas a operação não é permitida. 422 quer dizer que a requisição foi entendida e o payload estava errado. 429 quer dizer que você passou do limite e deve recuar em vez de repetir na hora.

Revisado em 20 de agosto de 2026

Passos

1. No 401, confira se a chave existe, não expirou e vai no header que você imagina — o motivo de sempre é uma colagem cortada.
2. No 403, leia o code: scope insuficiente, endereço fora da allow-list, ou chave de outro workspace. Reconectar não ajuda; a permissão é que precisa mudar.
3. No 422, leia o campo que a resposta cita e corrija o payload.
4. No 429, respeite os headers de limite e recue. Repetir na hora piora.
5. Guarde o requestId da resposta — é ele que permite ao suporte achar a sua chamada exata.

Como conferir o resultado

A mesma requisição passa depois da correção, e a resposta traz status 2xx com o objeto esperado.

O que costuma dar errado

• Tratar 403 como chave ruim e reemitir, o que não muda nada.
• Repetir um 429 num laço apertado.
• Mandar a chave ao suporte em vez do id da requisição.