Boas práticas
Idempotência, retentativas, timeouts e armazenamento de IDs.
- Guarde o applicantId junto do seu usuário — é a chave de todas as consultas.
- Use externalId com o seu ID interno para reconciliar relatórios.
- Marque testes com isTest: true — eles não entram no faturamento.
- Prefira webhooks a polling; se precisar consultar, use intervalos de 30s ou mais.
- Trate 5xx com retentativa e backoff exponencial; 4xx não deve ser repetido.
- Rotacione chaves de API periodicamente e revogue as que não usa.