Pessoas, empresas, CPFs, CNPJs, endereços reais, cartões de teste, contas bancárias e chaves Pix gerados sob demanda — determinísticos com semente fixa ou aleatórios. Suba o container no localhost, chame pela API HTTP ou abra a interface interativa direto no navegador, sem backend.
docker run --rm -p 45450:45450 ghcr.io/instituto-ama/generator-mock:latestDoze tipos prontos com regras de validação brasileiras: dígitos verificadores com pesos oficiais, e-mails protegidos em domínios RFC 2606 e cartões integrados ao simulador do Asaas.
| Tipo | Identificador | Descrição | Exemplo de dado gerado |
|---|---|---|---|
| Pessoa | person |
Nome completo, CPF, RG, CNH, PIS, data de nascimento, celular com DDD real e endereço vinculado | {"name": "Enzo Gabriel da Silva", "cpf": "111.444.777-35", "age": 28} |
| Empresa | company |
Razão social, nome fantasia, CNPJ filial 0001, atividade CNAE, endereço e sócios | {"corporateName": "Silva & Santos Tecnologia Ltda", "cnpj": "11.222.333/0001-81"} |
| Endereço | address |
Logradouro real, número, bairro, cidade, UF, código IBGE e CEP na faixa oficial do município | {"street": "Avenida Paulista", "number": "1578", "city": "São Paulo", "state": "SP"} |
| CPF | cpf |
11 dígitos com dois dígitos verificadores em módulo 11; rejeita dígitos repetidos | {"value": "11144477735", "formatted": "111.444.777-35"} |
| CNPJ | cnpj |
14 dígitos com matriz/filial e dois dígitos verificadores oficiais | {"value": "11222333000181", "formatted": "11.222.333/0001-81"} |
| CNH | cnh |
11 dígitos com dois verificadores sob o algoritmo do DENATRAN | {"value": "12345678901"} |
| PIS | pis |
11 dígitos com ponderação de pesos de 3 a 2 e módulo 11 | {"value": "12345678901", "formatted": "123.45678.90-1"} |
| RG | rg |
Padrão SP com 8 dígitos e dígito verificador módulo 11 (com suporte a X) | {"value": "12345678X", "formatted": "12.345.678-X"} |
| Cartão de crédito | credit-card |
Número de teste válido em Luhn; aprovação garantida ou recusa forçada no mock do Asaas | {"number": "4444444444444444", "brand": "VISA", "outcome": "APPROVE"} |
| Conta bancária | bank-account |
Banco real (código, nome, ISPB), agência, conta corrente ou poupança com dígitos | {"bank": {"code": "001", "name": "Banco do Brasil"}, "agency": "1234", "account": "123456-7"} |
| Chave Pix | pix-key |
Chaves nos formatos válidos: CPF, CNPJ, e-mail (example.*), telefone (+55) ou EVP (UUID v4) | {"type": "EMAIL", "key": "contato@example.com"} |
| Cobrança | charge |
Valor em centavos e reais, vencimento futuro, tipo de pagamento e referência externa | {"billingType": "PIX", "value": 150.00, "dueDate": "2026-11-15"} |
Soluções diretas para testes de software que lidam com requisitos e ecossistemas fiscais e bancários brasileiros.
Chega de digitar 111.444.777-35 ou inventar nomes repetidos ao validar telas de cadastro. Abra o gerador no navegador ou faça um curl para obter uma pessoa completa com endereço correspondente, telefone com DDD da cidade e documentos formatados prontos para copiar e colar.
curl https://instituto-ama.github.io/ama4devs/generator/api/v1/person
curl https://instituto-ama.github.io/ama4devs/generator/api/v1/cnpjUse o endpoint de validação rápido para verificar documentos em testes unitários e de API sem precisar carregar bibliotecas externas adicionais no seu backend de desenvolvimento.
curl https://instituto-ama.github.io/ama4devs/generator/api/v1/validate/cpf/11144477735Em testes de integração e CI, dados randômicos criam testes instáveis. Ao fornecer uma semente fixa (como seed=e2e-run-42), o gerador reproduz exatamente os mesmos CPFs, nomes, empresas e valores em todas as execuções, garantindo asserções previsíveis e reprodutíveis.
curl https://instituto-ama.github.io/ama4devs/generator/api/v1/company/42Rotas leves com respostas em JSON puro, CORS irrestrito para consumo direto do frontend e proteção local de acesso.
| Método e rota | Descrição | Resposta de sucesso |
|---|---|---|
GET /health |
Verificação de saúde do serviço | {"status": "ok", "service": "generator", "version": "..."} |
GET / |
Interface interativa da aplicação | Arquivo HTML da interface |
GET /core/:name.js |
Módulos ES browser-native do gerador | Código JavaScript nativo (sem transpilação) |
GET /v1/kinds |
Lista dos 12 tipos de dados suportados | {"kinds": [{"id": "person", "label": "Person"}, ...]} |
GET /v1/validate/:type/:value |
Validador de documentos (cpf, cnpj, cnh, pis) | {"type": "cpf", "value": "...", "valid": true|false} |
GET /v1/:kind |
Gera itens com parâmetros (count, seed, formatted, state, gender, etc.) | {"kind": "...", "seed": "...", "count": 1, "items": [...]} |
GET /_mock/asaas/status |
Verifica conectividade e clientes no mock do Asaas | {"asaasUrl": "...", "panelUrl": "...", "reachable": true, "customers": 12} |
POST /_mock/asaas/populate |
Cria clientes e emite cobranças no mock do Asaas | {"seed": "...", "customers": [...], "payments": [...], "errors": []} |