Öffentliche API
Die Namensgeneratoren über HTTP. Kostenlos, ohne Schlüssel und ohne Konto. Sie nutzt nie KI und kann keine fremden Projekte lesen.
Endpunkt
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
Parameter
| Name | Typ | Standard | Erlaubte Werte |
|---|---|---|---|
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 | Ganze Zahl von 1 bis 999,999 |
count | integer | 10 | Ganze Zahl von 1 bis 20 |
Beispiel
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'Ausprobieren
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'Antwort
Ein JSON-Objekt mit der Version "1", der angefragten Art und dem Seed, den Namen und der Adresse der Generatorseite. Gleiche Art und gleicher Seed liefern dieselben Namen, bis sich die Daten des Generators ändern.
Fehler
Fehler antworten mit einem HTTP-Status und einem Fehlerobjekt mit stabilem Code und lesbarer Meldung. Warte bei 429 und 503 auf Retry-After; wiederhole andere Fehler nicht unverändert.
| Status | Bedeutung |
|---|---|
400 | Bei einem Parameter stimmt das Format nicht oder er liegt außerhalb des Bereichs. Korrigiere die Anfrage, bevor du sie erneut sendest. |
405 | Nur GET und HEAD werden akzeptiert. |
408 | Die Anfrage kam zu langsam an. |
413 | Der Anfragetext ist größer als 2.048 Bytes. |
414 | Die Adresse ist länger als 1.024 Zeichen. |
415 | Der Text ist kein JSON. |
429 | Zu viele Anfragen von diesem Client. Warte die Sekunden aus Retry-After ab. |
500 | Auf unserer Seite ist etwas fehlgeschlagen. Versuche es später erneut. |
503 | Der Dienst ist ausgelastet. Warte die Sekunden aus Retry-After ab. |
Limits
- Pro Client: 10 Anfragen gleichzeitig, danach 30 pro Minute.
- Für den gesamten Dienst: 20 gleichzeitig, dann 10 pro Sekunde, höchstens 8 in Bearbeitung.
- Adressen über 1.024 Zeichen werden abgelehnt.
- Kein Schlüssel, kein Konto und keine Bezahlstufe. Es gibt keine Verfügbarkeitsgarantie.
OpenAPI-Dokument
Der vollständige Vertrag, für Code-Generatoren und API-Clients. /docs/openapi.json