Cobrativa API

Consultas integradas ao fluxo da sua empresa.

Conecte seu CRM, ERP, esteira de análise ou produto a uma única API JSON. Teste em homologação, automatize decisões e acompanhe cada chamada pelo painel.

Homologação com exemplos estáveis e sem consumo de saldo.

api.cobrativa.com.br
POST/v1/consultas/{slug}

Requisição

{
  "cpf": "12345678909"
}
AutenticaçãoBearer
AmbienteHomologação
FormatoJSON

Resposta

200 OK
{
  "id": "request-id",
  "status": "sucesso",
  "ambiente": "homologacao",
  "produto": {
    "versao": "1"
  },
  "cobranca": {
    "valor": 0,
    "moeda": "BRL"
  },
  "dados": { "resultado": "..." }
}
Um contrato estável para integrar, testar e colocar em produção.
01Uma única API JSON
02Homologação sem custo
03Produção com saldo pré-pago
04Respostas síncronas e assíncronas

Casos de uso

Uma API para operar, automatizar e criar produtos

A Cobrativa API entrega dados estruturados para sua empresa decidir como exibir, combinar e usar cada resultado dentro do próprio processo.

CRMs e ERPs

Consulte dados dentro do fluxo que sua equipe já utiliza, sem alternar entre painéis ou repetir cadastros.

Validação automática

Valide CPF, CNPJ e outros dados em etapas de cadastro, onboarding, análise e atualização cadastral.

Análise e decisão

Use respostas estruturadas para alimentar regras internas, esteiras de crédito, alertas e revisões manuais.

Relatórios com sua marca

Transforme os dados retornados em telas, documentos e relatórios com a identidade visual da sua empresa.

Revenda e white label

Ofereça consultas na sua própria solução com um envelope Cobrativa estável, sem expor integrações internas.

Rotinas em escala

Automatize consultas recorrentes, lotes controlados e processos que hoje dependem de operação manual.

Como funciona

Da primeira chave à operação em produção

O mesmo contrato acompanha sua integração do teste à chamada real.

  1. Etapa 01

    Crie sua conta

    Acesse o painel da Cobrativa API e conheça o catálogo disponível para integração.

  2. Etapa 02

    Gere a chave de homologação

    Teste autenticação, validações e respostas com exemplos estáveis, sem consumir saldo.

  3. Etapa 03

    Integre o endpoint

    Envie JSON por HTTPS e trate o mesmo envelope de resposta em homologação e produção.

  4. Etapa 04

    Ative a produção

    Adicione saldo, solicite sua chave de produção e acompanhe chamadas e custos no painel.

Contrato JSON

Uma resposta previsível para diferentes consultas

O envelope mantém status, ambiente, produto, cobrança e links de acompanhamento em uma estrutura estável. O conteúdo de dados varia conforme o produto consultado.

  • JSON padronizado

    Leia metadados da operação sempre nos mesmos campos.

  • Idempotency-Key

    Repita uma tentativa com segurança sem duplicar a operação lógica.

  • Catálogo versionado

    Identifique o produto e a versão que originaram cada resposta.

  • Dados do produto

    Consuma o conteúdo específico da consulta dentro do campo dados.

Explorar a documentação completa
response.jsonapplication/json
{
  "id": "request-id",
  "status": "sucesso",
  "ambiente": "producao",
  "produto": {
    "codigo": 3001,
    "slug": "consulta-escolhida",
    "nome": "Consulta escolhida",
    "versao": "1"
  },
  "cobranca": {
    "valor": 9.90,
    "moeda": "BRL"
  },
  "processado_em": "2026-09-16T14:30:00.000Z",
  "dados": { "resultado": "..." },
  "_links": {
    "resultado": "/v1/resultados/request-id"
  }
}

Operação controlada

Recursos para integrar com previsibilidade

O gateway organiza credenciais, cobrança, repetição de chamadas e acompanhamento de resultados para reduzir falhas na operação.

Credenciais separadas

Chaves distintas para homologação e produção ajudam a proteger o ambiente real.

Idempotência

A mesma operação lógica não gera uma nova consulta ou uma cobrança duplicada em tentativas repetidas.

Cobrança controlada

O saldo é reservado durante o processamento, debitado no sucesso e liberado em falhas técnicas.

Síncrono e assíncrono

Resultados imediatos e processamentos mais longos seguem um contrato previsível de acompanhamento.

Histórico consultável

Acompanhe execuções de homologação e produção pelo painel da sua conta.

Status público

Consulte a disponibilidade operacional dos produtos antes de agir sobre uma indisponibilidade.

Acompanhe a disponibilidade dos serviços

Consulte incidentes, manutenções e o estado operacional dos produtos.

Ver status da API

Modelo de uso

Teste sem custo. Pague pelas consultas em produção.

A homologação ajuda sua equipe a validar a integração antes de usar saldo real.

Homologação

Integre antes de consumir saldo

Execute exemplos estáveis, valide campos, trate códigos HTTP e confira seu histórico sem consumir saldo de produção.

Produção

Saldo pré-pago por consulta

Adicione saldo e consuma conforme sua operação. O catálogo informa o preço efetivo de cada produto disponível para sua conta.

Perguntas frequentes

Dúvidas sobre integração, respostas e cobrança

Respostas diretas para planejar sua implementação.

A homologação utiliza exemplos estáveis e permite testar autenticação, validação, limite de requisições, idempotência e histórico sem consumir saldo.

Comece pela homologação

Conecte a Cobrativa ao seu próximo fluxo

Crie sua conta, gere uma chave de homologação e valide a primeira chamada com a documentação da API.