​

Boas práticas de integração

​

Credenciais e token

​

Ambientes

1. Use HML para desenvolvimento e homologação.
2. Use produção somente depois de validar o fluxo.
3. Não misture token de HML com URL de produção.
4. Não misture token de produção com URL de HML.

​

Requests

1. Sempre envie Content-Type: application/json em requests com body JSON.
2. Sempre envie Authorization: Bearer {jwt_token} em chamadas protegidas.
3. Valide campos obrigatórios antes de chamar a API.
4. Envie CPF/CNPJ no formato esperado pelo seu fluxo.
5. Use timeout nas chamadas HTTP.

​

Retry

​

Respostas

1. Não use apenas o status HTTP para decidir sucesso de negócio.
2. Leia também status.code e status.message.
3. Trate status.code diferente de 200.
4. Salve externalId quando ele for retornado.
5. Lembre que resultado negativo não é necessariamente erro técnico.

if (body.status?.code !== 200) {
  throw new Error(body.status?.message || "Falha no processamento");
}

return body.result;

​

Logs

​

Produção