API pública
Los generadores de nombres por HTTP. Gratis, sin clave y sin cuenta. Nunca usa IA y no puede leer los proyectos de nadie.
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
| Nombre | Tipo | Predeterminado | 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 entero de 1 a 999,999 |
count | integer | 10 | Número entero de 1 a 20 |
Ejemplo
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'Pruébalo
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'Respuesta
Un objeto JSON con la versión "1", el tipo y la semilla que pediste, los nombres y la dirección de la página del generador. El mismo tipo y la misma semilla dan los mismos nombres hasta que cambian los datos del generador.
Errores
Los errores responden con un estado HTTP y un objeto de error con un código estable y un mensaje legible. Espera el Retry-After en 429 y 503; no repitas los demás errores tal cual.
| Estado | Significado |
|---|---|
400 | A un parámetro le falta el formato o está fuera de rango. Corrige la petición antes de volver a enviarla. |
405 | Solo se aceptan GET y HEAD. |
408 | La petición tardó demasiado en llegar. |
413 | El cuerpo de la petición supera los 2.048 bytes. |
414 | La dirección tiene más de 1.024 caracteres. |
415 | El cuerpo no es JSON. |
429 | Demasiadas peticiones de este cliente. Espera los segundos indicados en Retry-After. |
500 | Algo falló por nuestra parte. Inténtalo más tarde. |
503 | El servicio está ocupado. Espera los segundos indicados en Retry-After. |
Límites
- Cada cliente: 10 peticiones a la vez y luego 30 por minuto.
- Todo el servicio: 20 a la vez, luego 10 por segundo, y como máximo 8 en curso.
- Se rechazan las direcciones de más de 1.024 caracteres.
- Sin clave, sin cuenta y sin nivel de pago. No hay garantía de disponibilidad.
Documento OpenAPI
El contrato completo, para generadores de código y clientes de API. /docs/openapi.json