Openbare API
De naamgeneratoren via HTTP. Gratis, zonder sleutel en zonder account. Ze gebruikt nooit AI en kan niemands projecten lezen.
Endpoint
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
Parameters
| Naam | Type | Standaard | Toegestane waarden |
|---|---|---|---|
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 | Geheel getal van 1 tot 999,999 |
count | integer | 10 | Geheel getal van 1 tot 20 |
Voorbeeld
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'Probeer het
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'Respons
Een JSON-object met versie "1", het type en de seed die je vroeg, de namen en het adres van de pagina van de generator. Hetzelfde type en dezelfde seed geven dezelfde namen tot de gegevens van de generator veranderen.
Fouten
Fouten antwoorden met een HTTP-status en een foutobject met een vaste code en een leesbaar bericht. Wacht bij 429 en 503 op Retry-After; probeer andere fouten niet ongewijzigd opnieuw.
| Status | Betekenis |
|---|---|
400 | Een parameter heeft niet het juiste formaat of valt buiten het bereik. Pas het verzoek aan voordat je het opnieuw verstuurt. |
405 | Alleen GET en HEAD worden geaccepteerd. |
408 | Het verzoek deed er te lang over om aan te komen. |
413 | De inhoud van het verzoek is groter dan 2.048 bytes. |
414 | Het adres is langer dan 1.024 tekens. |
415 | De inhoud is geen JSON. |
429 | Te veel verzoeken van deze client. Wacht het aantal seconden uit Retry-After. |
500 | Er ging iets mis aan onze kant. Probeer het later opnieuw. |
503 | De dienst is druk. Wacht het aantal seconden uit Retry-After. |
Limieten
- Per client: 10 verzoeken tegelijk, daarna 30 per minuut.
- De hele dienst: 20 tegelijk, daarna 10 per seconde, maximaal 8 in behandeling.
- Adressen langer dan 1.024 tekens worden geweigerd.
- Geen sleutel, geen account en geen betaald niveau. Er is geen beschikbaarheidsgarantie.
OpenAPI-document
Het volledige contract, voor codegeneratoren en API-clients. /docs/openapi.json