Rookie API

Documentação da API

Endpoints disponíveis, autenticação, formato de retorno e exemplos práticos.

Token de acesso

Obtenha seu token via suporte no Telegram para autenticar as requisições.

REST via HTTP

Uma URL simples com GET. Funciona em qualquer linguagem com suporte HTTP.

Resposta JSON

Todos os endpoints retornam JSON estruturado, pronto para processar.

Autenticação

Todas as requisições exigem um token de acesso no caminho da URL. O token identifica sua conta e controla quais bases de dados você pode consultar.

Como obter seu token? Entre em contato com o suporte técnico via Telegram. O token é fornecido após validação da conta.

Estrutura de Requisição

As chamadas seguem o formato abaixo. Substitua os parâmetros pelos valores reais.

GET https://api.rookiedev.com/{token}/{endpoint}/{valor}

# Exemplo de chamada
GET https://api.rookiedev.com/MeuToken/cpf_cred_25/12345678900

# Python
import requests
r = requests.get("https://api.rookiedev.com/MeuToken/cpf_cred_25/12345678900")
print(r.json())

# JavaScript — nome exato
fetch("/MeuToken/nome_cred_25/" + encodeURIComponent("JOAO DA SILVA"))
  .then(r => r.json())
  .then(data => console.log(data));

Formato de Retorno

Todos os endpoints retornam application/json. O campo resultado contém os dados. Os exemplos mostram o formato geral; os campos podem variar conforme a base.

Atenção: Campos indisponíveis geralmente usam "sem informação". Arrays podem ser vazios. Trate o corpo da resposta além do status HTTP.

Em caso de falha, confira o campo erro no retorno. Os módulos podem retornar erros no corpo mesmo com HTTP 200.

{
  "status": "sem informacao",
  "erro": "Erro ao buscar informações",
  "direitos": "todos direitos resevados a © @ROOKIE DEV"
}

GET

CPF

Consulta completa de pessoa física — dados cadastrais, endereços, telefones, e-mails, parentes, veículos e score.

GET/{token}/{endpoint de CPF}/{cpf}

GET

Nome

Consulta por nome completo ou abreviado. Retorna lista de pessoas correspondentes com dados cadastrais.

GET/{token}/{endpoint de nome}/{nome}

Nome busca o nome exato; nome abreviado busca pelo início. A versão full traz mais detalhes.

GET

Placa

Dados do veículo — informações técnicas, identificação e restrições.

GET/{token}/placa_datasus/{placa}

GET

CNPJ

Consulta de empresas — em breve.

GET

Telefone

Consulta por telefone — dados cadastrais vinculados ao número.

GET/{token}/telefone/{telefone}

GET

CEP

Consulta de endereços por CEP — em breve.

GET

Email

Consulta por e-mail — em breve.

GET/{token}/email/{email}

GET

Foto

Consulta de fotos — em breve.

Precisa de ajuda?

Nossa equipe de suporte está disponível no Telegram para tirar dúvidas e fornecer tokens de acesso.

Falar com suporte