API pubblica
I generatori di nomi via HTTP. Gratis, senza chiave e senza account. Non usa mai l'IA e non può leggere i progetti di nessuno.
Endpoint
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
Parametri
| Nome | Tipo | Predefinito | Valori ammessi |
|---|---|---|---|
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 | Numero intero da 1 a 999,999 |
count | integer | 10 | Numero intero da 1 a 20 |
Esempio
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'Provalo
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'Risposta
Un oggetto JSON con la versione "1", il tipo e il seed richiesti, i nomi e l'indirizzo della pagina del generatore. Lo stesso tipo e lo stesso seed danno gli stessi nomi finché i dati del generatore non cambiano.
Errori
Gli errori rispondono con uno stato HTTP e un oggetto di errore con un codice stabile e un messaggio leggibile. Attendi il Retry-After su 429 e 503; non ripetere gli altri errori così come sono.
| Stato | Significato |
|---|---|
400 | Un parametro ha un formato errato o è fuori intervallo. Correggi la richiesta prima di inviarla di nuovo. |
405 | Sono accettati solo GET e HEAD. |
408 | La richiesta ha impiegato troppo ad arrivare. |
413 | Il corpo della richiesta supera i 2.048 byte. |
414 | L'indirizzo supera i 1.024 caratteri. |
415 | Il corpo non è JSON. |
429 | Troppe richieste da questo client. Attendi i secondi indicati in Retry-After. |
500 | Qualcosa è andato storto da parte nostra. Riprova più tardi. |
503 | Il servizio è occupato. Attendi i secondi indicati in Retry-After. |
Limiti
- Ogni client: 10 richieste insieme, poi 30 al minuto.
- Tutto il servizio: 20 insieme, poi 10 al secondo, al massimo 8 in corso.
- Gli indirizzi oltre i 1.024 caratteri vengono rifiutati.
- Nessuna chiave, nessun account e nessun livello a pagamento. Non c'è garanzia di disponibilità.
Documento OpenAPI
Il contratto completo, per generatori di codice e client API. /docs/openapi.json