Pular para o conteúdo

Primeiros passos

Da criação da conta até a primeira resposta da API, em cinco minutos.

Este guia leva você da conta recém-criada até a primeira consulta respondida. Não precisa falar com ninguém antes de testar.

1. Crie a conta

Acesse o painel e crie sua conta. Ao entrar, você já encontra o catálogo de consultas e o seu saldo.

2. Gere um token

No painel, abra Tokens e crie uma chave. Três escolhas importam:

  • Ambiente. Um token de teste devolve dado simulado e não gasta saldo. Comece por ele.
  • Escopos. O token só faz o que o escopo permite. Para consultar, ele precisa do escopo consultas.
  • Guarde na hora. O valor aparece uma única vez. Se perder, revogue e gere outro.

Guarde o token numa variável de ambiente, nunca no código:

export RADARDATA_TOKEN="cole_aqui_o_token_gerado_no_painel"

3. Faça a primeira chamada

Todas as consultas usam a mesma rota. O que muda é o identificador no fim do caminho:

curl -X POST https://api.radardata.com.br/api/v2/kyc-estendido \
  -H "Authorization: Bearer $RADARDATA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"documento": "52998224725"}'

4. Leia a resposta

Sucesso vem sempre em data e meta:

{
  "data": {
    "name": "FULANO DE TAL SANDBOX",
    "document": "52998224725",
    "age": 34,
    "isAdult": true,
    "isAlive": true,
    "cpfStatus": "REGULAR",
    "birthDate": "1990-01-01T00:00:00Z"
  },
  "meta": {
    "consulta_id": "0199c8f2-6b1e-7c3a-9d4f-2a5b8e7c1d90",
    "saldo": 48750,
    "preco": 0,
    "sandbox": true
  }
}

O consulta_id liga a chamada à linha do extrato. saldo e preco vêm em centavos. Com token de teste, sandbox vem true e o preço é zero.

Próximos passos