Ambientes

A API idCerberus possui dois ambientes principais: homologação e produção. Os endpoints, métodos, headers e bodies são os mesmos. O que muda é apenas a URL base usada na chamada.

Ambiente	Base URL	Quando usar
Homologação	`https://backoffice-hml.idcerberus.com`	Testes, validações e homologação da integração
Produção	`https://backoffice.idcerberus.com`	Consultas reais em operação

Não misture credenciais e dados de ambientes diferentes. Um token gerado em homologação deve ser usado com a URL de homologação. Um token gerado em produção deve ser usado com a URL de produção.

Como trocar de ambiente

Para trocar de homologação para produção, altere somente a URL base.

Item	Homologação	Produção
Base URL	`https://backoffice-hml.idcerberus.com`	`https://backoffice.idcerberus.com`
Gerar token	`/api/token-generate`	`/api/token-generate`
Executar serviço	`/api/service-api`	`/api/service-api`
Header	Igual	Igual
Body	Igual	Igual

Exemplo: gerar token

Homologação:

curl --location 'https://backoffice-hml.idcerberus.com/api/token-generate' \
  --header 'Content-Type: application/json' \
  --data '{
    "client": "{client}",
    "secret": "{secret}"
  }'

Produção:

curl --location 'https://backoffice.idcerberus.com/api/token-generate' \
  --header 'Content-Type: application/json' \
  --data '{
    "client": "{client}",
    "secret": "{secret}"
  }'

Exemplo: executar serviço

Homologação:

curl --location 'https://backoffice-hml.idcerberus.com/api/service-api' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "service": "SERVICE_PERSON_DATA_ENRICHMENT",
    "cpf": "cpf"
  }'

Produção:

curl --location 'https://backoffice.idcerberus.com/api/service-api' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "service": "SERVICE_PERSON_DATA_ENRICHMENT",
    "cpf": "cpf"
  }'

Erros comuns

Situação	Como resolver
Token de HML usado em produção	Gere um token novo na URL de produção
Token de produção usado em HML	Gere um token novo na URL de homologação
URL com ambiente errado	Confira se está usando `backoffice-hml` ou `backoffice`
Credenciais inválidas	Verifique `client`, `secret` e ambiente liberado

Recomendação

Comece sempre por homologação. Depois que o fluxo estiver validado, altere a URL base e as credenciais para produção.

Próximo passo

Quickstart

Faça a primeira chamada de API em homologação.

Autenticação

Entenda como gerar e renovar o token JWT em cada ambiente.

Troubleshooting

Resolva sintomas técnicos como token de outro ambiente ou 401/403.

Primeiros passos

Fluxos principais

Suporte e referência

POST /api/service-api

Pessoas

Empresas

Catálogo técnico

Ambientes

Ambientes

Como trocar de ambiente

Exemplo: gerar token

Exemplo: executar serviço

Erros comuns

Recomendação

Próximo passo

Quickstart

Autenticação

Troubleshooting

​Ambientes

​Como trocar de ambiente

​Exemplo: gerar token

​Exemplo: executar serviço

​Erros comuns

​Recomendação

​Próximo passo

Quickstart

Autenticação

Troubleshooting

Ambientes

Como trocar de ambiente

Exemplo: gerar token

Exemplo: executar serviço

Erros comuns

Recomendação

Próximo passo