API publique
Les générateurs de noms via HTTP. Gratuits, sans clé et sans compte. Ils n'utilisent jamais l'IA et ne peuvent lire les projets de personne.
Point d'accès
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
Paramètres
| Nom | Type | Par défaut | Valeurs autorisées |
|---|---|---|---|
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 | Nombre entier de 1 à 999,999 |
count | integer | 10 | Nombre entier de 1 à 20 |
Exemple
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'Essayer
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'Réponse
Un objet JSON avec la version "1", le type et la graine demandés, les noms et l'adresse de la page du générateur. Le même type et la même graine donnent les mêmes noms tant que les données du générateur ne changent pas.
Erreurs
Les erreurs répondent avec un statut HTTP et un objet d'erreur contenant un code stable et un message lisible. Attendez le Retry-After sur 429 et 503 ; ne relancez pas les autres erreurs telles quelles.
| Statut | Signification |
|---|---|
400 | Un paramètre n'a pas le bon format ou est hors limites. Corrigez la requête avant de la renvoyer. |
405 | Seuls GET et HEAD sont acceptés. |
408 | La requête a mis trop de temps à arriver. |
413 | Le corps de la requête dépasse 2 048 octets. |
414 | L'adresse dépasse 1 024 caractères. |
415 | Le corps n'est pas du JSON. |
429 | Trop de requêtes de ce client. Attendez le nombre de secondes indiqué dans Retry-After. |
500 | Un problème est survenu de notre côté. Réessayez plus tard. |
503 | Le service est occupé. Attendez le nombre de secondes indiqué dans Retry-After. |
Limites
- Chaque client : 10 requêtes à la fois, puis 30 par minute.
- Tout le service : 20 à la fois, puis 10 par seconde, 8 en cours au maximum.
- Les adresses de plus de 1 024 caractères sont refusées.
- Pas de clé, pas de compte et pas d'offre payante. Aucune garantie de disponibilité.
Document OpenAPI
Le contrat complet, pour les générateurs de code et les clients d'API. /docs/openapi.json