👤 Nomes Mock API

Gere nomes fictícios para preencher protótipos, formulários, tabelas e testes com dados realistas.

Base URL https://api.apicode.com.br

📌 Dados fictícios — todos os nomes são gerados aleatoriamente. Suporte a português (pt_BR), inglês (en_US) e espanhol (es_ES).

Gerar nomes (GET)

GET /api/names Gera nomes com parâmetros opcionais na query

Parâmetros

Parâmetro	Tipo	Default	Descrição
quantity	integer	1	Quantidade (1-50)
gender	string	any	`male`, `female`, `neutral` ou `any`
locale	string	pt_BR	`pt_BR`, `en_US` ou `es_ES`
format	string	full	`first`, `last` ou `full`
category	string	person	`person`, `product`, `business` ou `pet`

Exemplo

// GET /api/names?quantity=3&gender=female&locale=pt_BR&format=full&category=person
{
  "success": true,
  "message": "Nomes gerados com sucesso.",
  "data": [
    {
      "first_name": "Mariana",
      "last_name": "Oliveira",
      "full_name": "Mariana Oliveira",
      "gender": "female",
      "locale": "pt_BR",
      "category": "person"
    },
    {
      "first_name": "Camila",
      "last_name": "Santos",
      "full_name": "Camila Santos",
      "gender": "female",
      "locale": "pt_BR",
      "category": "person"
    }
  ],
  "meta": { "quantity": 3 }
}

Exemplo — categoria business

// GET /api/names?quantity=2&locale=pt_BR&category=business
{
  "success": true,
  "message": "Nomes gerados com sucesso.",
  "data": [
    {
      "name": "Nova Horizon Tecnologia",
      "category": "business",
      "locale": "pt_BR"
    },
    {
      "name": "BlueSoft Soluções",
      "category": "business",
      "locale": "pt_BR"
    }
  ],
  "meta": { "quantity": 2 }
}

Gerar nomes (POST)

POST /api/names/generate Gera nomes com parâmetros no body

Payload

{
  "quantity": 5,
  "gender": "any",
  "locale": "pt_BR",
  "format": "full",
  "category": "business"
}

Resposta

{
  "success": true,
  "message": "Nomes gerados com sucesso.",
  "data": [
    { "name": "Nova Horizon Tecnologia", "category": "business", "locale": "pt_BR" },
    { "name": "BlueSoft Soluções", "category": "business", "locale": "pt_BR" }
  ],
  "meta": { "quantity": 5 }
}

Exemplos de uso

// GET — nomes femininos em português const response = await fetch( 'https://api.apicode.com.br/api/names?quantity=5&gender=female&locale=pt_BR&format=full' ); const data = await response.json(); console.log(data.data); // POST — nomes de empresas const biz = await fetch('https://api.apicode.com.br/api/names/generate', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ quantity: 3, category: "business", locale: "pt_BR" }) });

// GET const response = await axios.get('https://api.apicode.com.br/api/names', { params: { quantity: 5, gender: "male", locale: "en_US", format: "full" } }); console.log(response.data.data); // POST const biz = await axios.post('https://api.apicode.com.br/api/names/generate', { quantity: 3, category: "pet", locale: "pt_BR" });

# GET — 3 nomes femininos em português curl "https://api.apicode.com.br/api/names?quantity=3&gender=female&locale=pt_BR&format=full" # POST — nomes de pets curl -X POST https://api.apicode.com.br/api/names/generate \ -H "Content-Type: application/json" \ -d '{"quantity":3,"category":"pet","locale":"pt_BR"}'

Limites

Regra	Valor
Quantidade mínima	1
Quantidade máxima	50
Rate limit por IP	10 requisições/minuto
Locais suportados	pt_BR, en_US, es_ES
Categorias	person, product, business, pet