API idCerberus

Integre consultas de CPF (Cadastro de Pessoa Física, documento de identificação individual no Brasil), CNPJ (Cadastro Nacional da Pessoa Jurídica, documento de identificação de empresas), OCR, biometria, risco, compliance e onboarding digital em um fluxo único de API. Esta documentação foi organizada para dois momentos: testar rápido em homologação e implementar com segurança em produção.

Caminho mais curto (consulta avulsa via API)

1

Gere um token

Use POST /api/token-generate com client e secret do produto.
2

Escolha o service

Abra o índice de services ou a API Reference e copie o alias correto.
3

Monte o payload

Envie service e os campos obrigatórios do produto, como cpf, cnpj, image1, image2, documentType ou key.
4

Execute em HML

Chame POST https://backoffice-hml.idcerberus.com/api/service-api com Authorization: Bearer {jwt_token}.
5

Leia o resultado

Use result como retorno de negócio e status.message, onboardingStatus e externalId para diagnóstico.
Vai capturar documento e selfie do usuário num cadastro guiado, em vez de fazer consultas avulsas? Esse é o fluxo de onboarding via SDK ou Cliente Web. Veja Onboarding via SDK em vez dos passos acima.

Ou explore por objetivo

Testar em 5 minutos

Configure token, ambiente e primeira chamada no Postman sem escrever código. Prefere não instalar nada? Use o painel de teste embutido em qualquer página da API Reference.

Receitas de teste

Copie fluxos prontos para CPF, CNPJ, OCR, Face Index, risco PJ e score PF.

Executar um service

Entenda o contrato do POST /api/service-api e copie payloads prontos.

OCR e imagem

Veja como testar CNH, RG, cartão CNPJ, comprovante de endereço e documentos com base64.

Catálogo de services

Pesquise por alias, documento, categoria, campo ou objetivo de negócio.

Busca rápida

Encontre services por CPF, CNPJ, OCR, Face Index, erro, campo obrigatório ou alias.

Services por caso de uso

Escolha o service certo a partir do que você precisa validar ou consultar.

Erros comuns

Diagnóstico rápido para token, acesso, payload, imagem, retorno vazio e falha externa.

Dúvidas e Soluções

Perguntas e respostas diretas por tema, antes de abrir chamado de suporte.

Webhooks

Receba aviso automático quando um onboarding mudar de status, sem polling.

Mais usados

Modelos de integração

Exemplo rápido

Gere um token:
Use o token para executar uma consulta:
Para a lista completa de endpoints, ambientes e o padrão de resposta detalhado, veja Visão geral.

Próximos passos

  1. Para testar no Postman, veja Postman do zero.
  2. Para copiar fluxos completos, veja Receitas prontas.
  3. Para OCR, base64 e imagens, veja OCR via Service API.
  4. Para escolher o service certo, veja Services por caso de uso.
  5. Para diagnosticar falhas, veja Erros comuns de integração.