Gerador de pessoa

Uma pessoa fictícia é gerada ao abrir a página. Escolha a nacionalidade, o sexo e, para o Brasil, o estado, ou clique em "Gerar pessoa" para criar outra.

Sexo

Como funciona

  • A pessoa é gerada no servidor e não fica armazenada em lugar nenhum.
  • Brasileiros vêm com CPF e RG válidos (o RG segue a regra de São Paulo) e endereço real: o CEP existe e corresponde à rua, ao bairro e à cidade. Os telefones usam o DDD da cidade, e o nome leva um sobrenome da mãe e depois um do pai.
  • Nas outras nacionalidades, nome, endereço, telefone e data seguem o formato do país, com dados do Faker. O endereço é fictício e não há documentos; campos que o Faker não tem para o país ficam de fora.
  • O e-mail usa domínios reservados para testes (example.com), então nenhuma mensagem chega a alguém de verdade.
  • Os dados servem apenas para testes e não pertencem a nenhuma pessoa real.

Como usar a API

Você pode integrar o gerador de pessoa à sua aplicação pela nossa API REST.

Endpoint

GET /api/generators/person

Parâmetros de query

nationality
Opcional. O código do país, como "BR" ou "DE". Padrão: "BR". A resposta de outras nacionalidades traz "phone", "address", "zipCode" e "country" em vez dos campos brasileiros.
sex
Opcional. "female" ou "male". Sem ele, o sexo é sorteado. Brasileiros vêm com "Feminino" ou "Masculino" na resposta.
state
Opcional, só com nationality=BR. A sigla do estado, como "SP". Sem ela, o estado é sorteado.

Exemplo com curl

curl "https://devtools.vmotta.dev/api/generators/person?nationality=DE&sex=female"

Resposta

{
  "person": {
    "nationality": "DE",
    "name": "Michaela Löser",
    "sex": "female",
    "birthdate": "14.05.1984",
    "age": 42,
    "motherName": "Malin Löser",
    "fatherName": "Jordan Löser",
    "email": "michaela.loser83@example.com",
    "password": "zmwbsy-abdmnZ-3femhv",
    "phone": "(00792) 9666250",
    "address": "Franz-Hitze-Str. 429",
    "city": "Neu Alishascheid",
    "state": "Bremen",
    "zipCode": "58954",
    "country": "Deutschland",
    "height": "1,64 m",
    "weight": "68 kg",
    "bloodType": "A+"
  }
}