Endpoint Público

API Gerador de Dados para Desenvolvedores

Integração JSON programável e de baixa latência. Domine como gerar dados para testes no Brasil injetando perfis completos diretamente no Cypress, Playwright ou pipelines CI/CD.

Workflow: O Padrão para Injeção QA

Testadores (Software Testers / SDET) sabem que depender do preenchimento visual de formulários consome memória e atrasa em até 70% o pipeline E2E.

Ao invés de programar o Selenium para digitar nome a nome, chame a rota /api/generate em massa antes do teste iniciar, capture um CPF Válido para QA e faça o Seed do seu banco na memória (In-memory Mock Database).

Parâmetros (Body Request)

  • quantidade

    Volume de perfis gerados.

    Inteiro (Max: 50)
  • sexo

    Filtro demográfico nominal.

    "masculino" | "feminino"
  • pontuacao

    Regex output formatting.

    "sim" | "nao"

Simulador (Load Testing Response)

O JSON devolvido possuirá um array multidimensional em `data` além dos metadados analíticos em `meta`.

{
  "success": true,
  "meta": {
    "generated_count": 1,
    "options": {
      "pontuacao": "sim",
      "estado": "SP"
    }
  },
  "data": {
    "nome": "Miguel Silva",
    "cpf": "123.456.789-00",
    "rg": "12.345.678-9",
    "estado": "SP",
    "cidade": "Campinas"
  }
}
cURL Request
curl -X POST https://geradordepessoas.org/api/generate \
-H "Content-Type: application/json" \
-d '{
  "quantidade": 5,
  "sexo": "masculino",
  "estado": "SP",
  "pontuacao": "sim"
}'
JavaScript (Fetch)
// Exemplo Fetch Nativo (Browser/Node.js)
const generateMockData = async () => {
  const response = await fetch('https://geradordepessoas.org/api/generate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      quantidade: 10,
      idade: 25,
      estado: 'RJ'
    })
  });
  
  const { data } = await response.json();
  console.log("Perfis Mocks:", data);
};

generateMockData();
Python (Requests)
import requests
import json

# Workflow QA: Alimentando Banco de Dados
url = "https://geradordepessoas.org/api/generate"
payload = {
    "quantidade": 50, # MAX: 50 por request
    "pontuacao": "nao",
    "sexo": "aleatorio"
}

response = requests.post(url, json=payload)

if response.status_code == 200:
    pessoas = response.json()["data"]
    for p in pessoas:
        # DB.insert(p) -> Injeção local SQL/NoSQL
        print(f"CPF Válido para QA inserido: {p['cpf']}")