API Documentation
API REST para geração e validação de dados brasileiros. Rápida, confiável e fácil de usar.
Obtenha sua API Key
Acesse /settings/api-keys e crie uma nova chave
Faça sua primeira requisição
Use sua API key no header x-api-key
// Generate CPF
const response = await fetch('https://devthru.com/api/v1/generate/cpf', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
body: JSON.stringify({
quantity: 10,
options: { formatted: true }
})
});
const data = await response.json();
console.log(data);
// { success: true, data: ["123.456.789-00", ...], count: 10 }Monitore seu uso
Acompanhe suas estatísticas em tempo real via GET /api/v1/usage
/api/v1/generate/{tool}Gera dados para testes. Suporta: cpf, cnpj, rg, cnh, inscricao-estadual, titulo-eleitor, pis, name, email, phone, address, person, license-plate, renavam, chassis, credit-card, iban, uuid, password, lorem
Ver exemplo
Request:
{
"quantity": 10,
"options": { "formatted": true }
}Response:
{
"success": true,
"data": ["123.456.789-00", ...],
"count": 10
}/api/v1/validate/{tool}Valida documentos brasileiros. Suporta: cpf, cnpj, pis, titulo-eleitor, cnh, iban, inscricao-estadual
Ver exemplo
Request:
{
"value": "123.456.789-00"
}Response:
{
"success": true,
"valid": true,
"value": "123.456.789-00"
}/api/v1/usageRetorna estatísticas de uso da API
Ver exemplo
Response:
{
"success": true,
"period": "monthly",
"used": 150,
"limit": 1000,
"remaining": 850,
"resetAt": "2025-12-01T00:00:00Z",
"topTools": [
{ "tool": "cpf", "count": 80 },
{ "tool": "cnpj", "count": 45 }
]
}Free Plan
-
Sem acesso à API
Pro Plan
-
Sem acesso à API
Business Plan
1,000,000
requests por mês
Todas as respostas incluem headers de rate limit: X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset
INVALID_API_KEYAPI key inválida ou ausenteRATE_LIMIT_EXCEEDEDLimite de requisições excedidoINVALID_INPUTDados de entrada inválidosTOOL_NOT_FOUNDFerramenta não encontradaINTERNAL_ERRORErro interno do servidor