Formato de erro
Todos os erros retornam uma resposta JSON com um campodetail:
code estruturado para tratamento programático:
Códigos de Status HTTP
Códigos de erro comuns
Estratégia de retry
Para erros429 e 5xx, implemente backoff exponencial: