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)
- Inteiro (Max: 50)
quantidadeVolume de perfis gerados.
- "masculino" | "feminino"
sexoFiltro demográfico nominal.
- "sim" | "nao"
pontuacaoRegex output formatting.
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']}")