​

Boas práticas de integração

​

Credenciais e token

​

Ambientes

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

​

Requests

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

​

Retry

​

Respostas

• Não use apenas o status HTTP para decidir sucesso de negócio.
• Leia também status.code e status.message.
• Trate status.code diferente de 200.
• Salve externalId quando ele for retornado.
• 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