Da primeira requisição ao resultado, empresa, execução e evidência permanecem relacionadas.
Uma API não deve devolver apenas dados soltos
A integração da Base39 permite pesquisar entidades, consultar fontes, enviar documentos, executar workflows e acompanhar resultados dentro dos sistemas da organização.
Comece pela entidade
Identifique a empresa ou pessoa antes de executar verificações. Isso reduz duplicidade e mantém consultas, documentos e eventos associados ao dossiê correto.
Execute consultas e workflows
Use a capacidade específica quando a pergunta estiver bem definida ou dispare um workflow para coordenar fontes, documentos, agentes, critérios e revisão.
Acompanhe o estado real da execução
Operações assíncronas devem expor identificador, estado e erros até que fatos, evidências e resultados estejam disponíveis. Um aceite de processamento não equivale a conclusão.
Use contratos publicados
O SDK oficial reduz ambiguidade ao expor parâmetros, respostas e erros alinhados aos contratos da API. Integrações devem partir da documentação e dos tipos publicados, não de exemplos inferidos.
Preserve segurança por ambiente
- credenciais diferentes por ambiente;
- menor permissão necessária;
- segredos apenas no backend;
- tratamento explícito de timeout e erro;
- dados pessoais limitados à finalidade autorizada;
- logs sem credenciais ou conteúdo sensível.
Planeje exceções
Ausência de dados, correspondência parcial e falha de fonte precisam chegar ao produto como estados distintos. Não converta indisponibilidade em aprovação ou resultado vazio.
Comece pela documentação
Consulte autenticação, ambientes, limites, erros, SDK e contratos publicados antes de implementar.
CTA: Acessar documentação