Documentação APIs Mock

Guia completo para usar as APIs de teste gratuitas. Gere dados válidos instantaneamente.

Índice

Introdução Endpoints Disponíveis Autenticação Parâmetros Exemplos de Uso Tratamento de Erros

Introdução

As APIs Mock são ferramentas gratuitas e sem autenticação para gerar dados de teste de alta qualidade. Foram criadas para ajudar desenvolvedores a testar suas aplicações com dados realistas sem precisar de dados reais.

Todas as respostas incluem dados válidos:

CPF com dígitos verificadores corretos
CNPJ com dígitos verificadores corretos
Endereços com cidades reais do Brasil
Nomes completos realistas
Dados de contato válidos

Autenticação

Sem Autenticação Necessária!

Todas as APIs Mock são públicas e não requerem autenticação. Você pode chamar os endpoints diretamente sem necessidade de tokens ou chaves de API.

URL Base:

https://www.richardalgarve.com.br/api/mock

Endpoints Disponíveis

GET /pessoa-fisica

Gera dados completos de uma pessoa física com CPF válido.

Exemplo de Requisição:

curl -X GET "https://www.richardalgarve.com.br/api/mock/pessoa-fisica?quantidade=1"

Resposta de Exemplo:

{
  "data": [
    {
      "tipo": "PF",
      "nome": "João da Silva Santos",
      "cpf": "12345678910",
      "cpf_formatado": "123.456.789-10",
      "data_nascimento": "15/03/1990",
      "email": "joao.santos@email.com",
      "telefone": "(11) 991234567",
      "endereco": {
        "logradouro": "Rua Principal",
        "numero": 123,
        "bairro": "Centro",
        "cidade": "São Paulo",
        "estado": "SP",
        "cep": "01234-567"
      }
    }
  ]
}

GET /pessoa-juridica

Gera dados completos de uma empresa com CNPJ válido.

Exemplo de Requisição:

curl -X GET "https://www.richardalgarve.com.br/api/mock/pessoa-juridica?quantidade=1"

Resposta de Exemplo:

{
  "data": [
    {
      "tipo": "PJ",
      "razao_social": "Tech Solutions LTDA",
      "nome_fantasia": "Tech Solutions",
      "cnpj": "12345678000195",
      "cnpj_formatado": "12.345.678/0001-95",
      "inscricao_estadual": "123.456.789.012",
      "email": "contato@techsolutions.com.br",
      "telefone": "(11) 3123-4567",
      "endereco": {
        "logradouro": "Avenida Paulista",
        "numero": 1000,
        "complemento": "Sala 500",
        "bairro": "Bela Vista",
        "cidade": "São Paulo",
        "estado": "SP",
        "cep": "01311-100"
      }
    }
  ]
}

GET /cpf

Gera um ou mais CPFs válidos com dígitos verificadores corretos.

Exemplo de Requisição:

curl -X GET "https://www.richardalgarve.com.br/api/mock/cpf?quantidade=5&formatado=true"

Resposta de Exemplo:

{
  "data": [
    "123.456.789-10",
    "234.567.890-21",
    "345.678.901-32",
    "456.789.012-43",
    "567.890.123-54"
  ]
}

GET /cnpj

Gera um ou mais CNPJs válidos com dígitos verificadores corretos.

Exemplo de Requisição:

curl -X GET "https://www.richardalgarve.com.br/api/mock/cnpj?quantidade=3&formatado=true"

Resposta de Exemplo:

{
  "data": [
    "12.345.678/0001-95",
    "23.456.789/0001-06",
    "34.567.890/0001-17"
  ]
}

Parâmetros de Query

`quantidade`

Número de itens a gerar (padrão: 1, máximo: 1000)

Tipo: Integer

Exemplo: ?quantidade=10

`formatado`

Se true, retorna CPF/CNPJ com pontuação (padrão: false)

Tipo: Boolean (true/false)

Exemplo: ?formatado=true

Exemplos de Uso

JavaScript / Fetch API

// Gerar pessoa física
fetch('https://www.richardalgarve.com.br/api/mock/pessoa-fisica?quantidade=1')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Erro:', error));

// Gerar 50 CPFs formatados
fetch('https://www.richardalgarve.com.br/api/mock/cpf?quantidade=50&formatado=true')
  .then(response => response.json())
  .then(data => console.log(data.data))
  .catch(error => console.error('Erro:', error));

Python / Requests

import requests

# Gerar pessoa jurídica
response = requests.get('https://www.richardalgarve.com.br/api/mock/pessoa-juridica?quantidade=1')
data = response.json()
print(data['data'][0])

# Gerar 100 CNPJs
response = requests.get(
    'https://www.richardalgarve.com.br/api/mock/cnpj',
    params={'quantidade': 100, 'formatado': True}
)
cnpjs = response.json()['data']
print(cnpjs)

cURL

# Gerar 1 pessoa física
curl "https://www.richardalgarve.com.br/api/mock/pessoa-fisica?quantidade=1"

# Gerar 10 CPFs sem formatação
curl "https://www.richardalgarve.com.br/api/mock/cpf?quantidade=10&formatado=false"

# Gerar 5 CNPJs com formatação
curl "https://www.richardalgarve.com.br/api/mock/cnpj?quantidade=5&formatado=true" \
  -H "Accept: application/json"

PHP / cURL

<?php
// Gerar pessoa física
$url = 'https://www.richardalgarve.com.br/api/mock/pessoa-fisica?quantidade=1';
$response = file_get_contents($url);
$data = json_decode($response, true);

echo $data['data'][0]['nome']; // Exibe o nome

// Gerar CPFs
$url = 'https://www.richardalgarve.com.br/api/mock/cpf?quantidade=5&formatado=true';
$cpfs = json_decode(file_get_contents($url), true);
print_r($cpfs['data']);
?>

Tratamento de Erros

400 Bad Request

Parâmetros inválidos ou ausentes

{ "error": "Parâmetro 'quantidade' deve ser um número entre 1 e 1000" }

404 Not Found

Endpoint não existe

{ "error": "Endpoint não encontrado" }

500 Server Error

Erro no servidor

{ "error": "Erro interno do servidor" }

Pronto para começar?

Testador Interativo