Documentação

DataQuery API

API REST para consulta de dados cadastrais por CPF. Integre em minutos usando sua linguagem favorita.

ℹ️

Todas as respostas são retornadas em JSON. Todas as requisições devem incluir um token válido via query string.

Base URL

https://zoomiressdat.shop

Autenticação

A autenticação é feita por token via query string. Inclua o parâmetro token em todas as requisições.

⚠️

Requisições sem token ou com token inválido receberão 401 ou 403 como resposta.

GET /consultar

Consulta dados cadastrais completos a partir de um CPF.

GET /consultar?cpf={cpf}&token={token}

Parâmetros

Parâmetro	Tipo	Status	Descrição
`cpf`	string	obrigatório	CPF sem pontos ou traços — 11 dígitos
`token`	string	obrigatório	Token de acesso fornecido pelo administrador

Exemplos de código

import requests

url   = "https://seu-dominio.com/consultar"
token = "meu-token-secreto"
cpf   = "12345678901"

response = requests.get(url, params={"cpf": cpf, "token": token})
data = response.json()

if data["status"] == "OK":
    print(f"Nome: {data['nome']}")
    print(f"Nascimento: {data['nascimento']}")
else:
    print(f"Erro: {data['mensagem']}")

const axios = require('axios');

const token = 'meu-token-secreto';
const cpf   = '12345678901';

axios.get('https://seu-dominio.com/consultar', {
  params: { cpf, token }
})
.then(res => {
  const data = res.data;
  if (data.status === 'OK') {
    console.log(`Nome: ${data.nome}`);
    console.log(`Nascimento: ${data.nascimento}`);
  }
})
.catch(err => console.error(err.message));

$token = 'meu-token-secreto';
$cpf   = '12345678901';

$url = 'https://seu-dominio.com/consultar?cpf=' . $cpf . '&token=' . $token;

$response = file_get_contents($url);
$data     = json_decode($response, true);

if ($data['status'] === 'OK') {
    echo "Nome: " . $data['nome'] . PHP_EOL;
    echo "Nascimento: " . $data['nascimento'] . PHP_EOL;
} else {
    echo "Erro: " . $data['mensagem'];
}

curl -X GET \
  "https://seu-dominio.com/consultar?cpf=12345678901&token=meu-token-secreto" \
  -H "Accept: application/json"

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    token := "meu-token-secreto"
    cpf   := "12345678901"

    url := fmt.Sprintf(
        "https://seu-dominio.com/consultar?cpf=%s&token=%s",
        cpf, token,
    )

    resp, _ := http.Get(url)
    body, _ := io.ReadAll(resp.Body)

    var data map[string]any
    json.Unmarshal(body, &data)
    fmt.Println(data["nome"])
}

import java.net.URI;
import java.net.http.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String token = "meu-token-secreto";
        String cpf   = "12345678901";

        String url = "https://seu-dominio.com/consultar?cpf="
                     + cpf + "&token=" + token;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .GET()
            .build();

        HttpResponse<String> response = client.send(
            request, HttpResponse.BodyHandlers.ofString()
        );

        System.out.println(response.body());
    }
}

Códigos HTTP

200

Consulta realizada com sucesso

400

Parâmetro cpf ausente na requisição

401

Token não informado na requisição

403

Token inválido ou sem permissão

404

CPF não encontrado na base de dados

500

Erro interno ao consultar a fonte de dados

Formato de Erro

Todos os erros seguem o mesmo formato JSON:

JSON

{
  "status":   "ERRO",
  "mensagem": "Token inválido ou sem permissão de acesso."
}