API pública
Os geradores de nomes via HTTP. Grátis, sem chave e sem conta. Nunca usa IA e não consegue ler os projetos de ninguém.
Endpoint
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
Parâmetros
| Nome | Tipo | Padrão | Valores permitidos |
|---|---|---|---|
kind | string | fantasy | fantasy, fantasy-last, elf, dwarf, dragon, kingdom, town, village, tavern, wizard, orc, city, guild, ship, sword, spell, god, demon, vampire, pirate, knight, sci-fi-planet, alien, starship |
seed | integer | 1 | Número inteiro de 1 a 999,999 |
count | integer | 10 | Número inteiro de 1 a 20 |
Exemplo
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'Experimente
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'Resposta
Um objeto JSON com a versão "1", o tipo e a semente que você pediu, os nomes e o endereço da página do gerador. O mesmo tipo e a mesma semente dão os mesmos nomes até os dados do gerador mudarem.
Erros
Os erros respondem com um status HTTP e um objeto de erro com um código estável e uma mensagem legível. Aguarde o Retry-After em 429 e 503; não repita os outros erros como estão.
| Status | Significado |
|---|---|
400 | Um parâmetro está sem o formato certo ou fora do intervalo. Corrija a requisição antes de enviar de novo. |
405 | Apenas GET e HEAD são aceitos. |
408 | A requisição demorou demais para chegar. |
413 | O corpo da requisição é maior que 2.048 bytes. |
414 | O endereço tem mais de 1.024 caracteres. |
415 | O corpo não é JSON. |
429 | Requisições demais deste cliente. Aguarde os segundos indicados em Retry-After. |
500 | Algo falhou do nosso lado. Tente de novo mais tarde. |
503 | O serviço está ocupado. Aguarde os segundos indicados em Retry-After. |
Limites
- Cada cliente: 10 requisições ao mesmo tempo, depois 30 por minuto.
- O serviço todo: 20 ao mesmo tempo, depois 10 por segundo, no máximo 8 em andamento.
- Endereços com mais de 1.024 caracteres são recusados.
- Sem chave, sem conta e sem nível pago. Não há garantia de disponibilidade.
Documento OpenAPI
O contrato completo, para geradores de código e clientes de API. /docs/openapi.json