API ServicesPomatti

Integre geradores, validadores e conversores no seu sistema. API REST simples e documentada.

Planos da API

Free

R$0 /mês
100 requisições/mês • Todos os endpoints
Criar conta grátis

Pro

R$14,90 /mês
1.000 requisições/mês • Batch até 1.000 itens
Assinar Pro

Business

R$39,90 /mês
50.000 requisições/mês • Batch 10.000 • Webhooks
Assinar Business

Autenticação

Todas as requisições precisam incluir o header Authorization: Bearer SUA_API_KEY. Crie sua conta grátis e sua chave de API será gerada automaticamente. Acesse Minha Conta para ver, copiar ou regenerar sua chave.
Base URL: https://api-tools.servicespomatti.com/v1
Documentação interativa (Swagger)

Teste os endpoints diretamente no navegador com "Try it out".

Abrir Swagger UI

Endpoints

GET /generate/cpf Gerar CPF válido

Gera um CPF matematicamente válido para testes.

Parâmetros (query string):
  • mask — true ou false (padrão: true). Retorna com pontuação.
  • count — Quantidade (1-100, padrão: 1). Plano Business: até 1000.
curl -H "Authorization: Bearer SUA_API_KEY" \
  "https://api-tools.servicespomatti.com/v1/generate/cpf?mask=true&count=3"
Resposta: 
{
  "success": true,
  "data": [
    "123.456.789-09",
    "987.654.321-00",
    "456.789.123-45"
  ]
}
GET /generate/cnpj Gerar CNPJ válido

Mesma interface do CPF. Parâmetros: mask, count.

GET /v1/generate/cnpj?mask=true&count=5
GET /generate/credit-card Gerar cartão de crédito para teste

Gera número de cartão válido (Luhn) com CVV e validade.

Parâmetros:
  • brand — visa, mastercard, amex, elo (padrão: visa)
  • count — Quantidade (1-100)
Resposta: 
{
  "success": true,
  "data": [{
    "number": "4532 1234 5678 9012",
    "brand": "visa",
    "cvv": "123",
    "expiry": "08/29"
  }]
}
GET /generate/person Gerar pessoa fictícia completa

Gera dados fictícios completos: nome, CPF, RG, email, telefone, endereço.

Parâmetros:
  • gender — male, female, random (padrão: random)
  • count — Quantidade (1-1000 no Business)
Resposta: 
{
  "success": true,
  "data": [{
    "name": "João Silva Santos",
    "gender": "male",
    "cpf": "123.456.789-09",
    "rg": "12.345.678-9",
    "birth_date": "1990-05-15",
    "email": "[email protected]",
    "phone": "(11) 98765-4321",
    "address": {
      "street": "Rua das Flores, 123",
      "city": "São Paulo",
      "state": "SP",
      "zip": "01234-567"
    }
  }]
}
POST /validate/cpf Validar CPF 
POST /v1/validate/cpf
Content-Type: application/json

{ "cpf": "123.456.789-09" }
Resposta: 
{ "success": true, "valid": true, "formatted": "123.456.789-09" }
POST /validate/cnpj Validar CNPJ 
POST /v1/validate/cnpj
Content-Type: application/json

{ "cnpj": "12.345.678/0001-95" }
Resposta: 
{ "success": true, "valid": true, "formatted": "12.345.678/0001-95" }
POST /validate/email Validar formato de email 
POST /v1/validate/email
Content-Type: application/json

{ "email": "[email protected]" }
Resposta: 
{ "success": true, "valid": true, "domain": "example.com", "disposable": false }
POST /generate/hash Gerar hash de texto 
POST /v1/generate/hash
Content-Type: application/json

{ "text": "Hello World", "algorithm": "sha256" }

Algoritmos: md5, sha1, sha256, sha512, all

GET /generate/uuid Gerar UUID v4 
GET /v1/generate/uuid?count=10

Rate Limits

As requisições são limitadas por chave de API. Os headers de resposta incluem: 

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4987
X-RateLimit-Reset: 1711929600

Erros

// 401 - Unauthorized
{ "success": false, "error": "Invalid API key" }

// 429 - Rate limit exceeded
{ "success": false, "error": "Rate limit exceeded", "retry_after": 3600 }

// 400 - Bad request
{ "success": false, "error": "Invalid parameter: count must be between 1 and 100" }

Pronto para começar?

Criar conta grátis — gerar API key