Publiczne API

Generatory nazw przez HTTP. Za darmo, bez klucza i bez konta. Nigdy nie używa AI i nie może czytać niczyich projektów.

Endpoint

GEThttps://musael.com/api/public/v1/names

Generate up to 20 names using one of 24 deterministic generators, without AI or account access.

Parametry

Nazwa	Typ	Domyślnie	Dozwolone wartości
`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`	Liczba całkowita od 1 do 999,999
`count`	integer	`10`	Liczba całkowita od 1 do 20

Przykład

curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'

Wypróbuj

curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'

Odpowiedź

Obiekt JSON z wersją "1", żądanym rodzajem i ziarnem, nazwami oraz adresem strony generatora. Ten sam rodzaj i to samo ziarno dają te same nazwy, dopóki dane generatora się nie zmienią.

Błędy

Błędy zwracają status HTTP i obiekt błędu ze stałym kodem i czytelnym komunikatem. Przy 429 i 503 poczekaj zgodnie z Retry-After; innych błędów nie ponawiaj bez zmian.

Status	Znaczenie
`400`	Parametr ma zły format lub jest poza zakresem. Popraw żądanie, zanim wyślesz je ponownie.
`405`	Akceptowane są tylko GET i HEAD.
`408`	Żądanie dotarło zbyt wolno.
`413`	Treść żądania jest większa niż 2048 bajtów.
`414`	Adres jest dłuższy niż 1024 znaki.
`415`	Treść nie jest JSON.
`429`	Za dużo żądań od tego klienta. Poczekaj liczbę sekund z Retry-After.
`500`	Po naszej stronie coś zawiodło. Spróbuj później.
`503`	Usługa jest zajęta. Poczekaj liczbę sekund z Retry-After.

Limity

Każdy klient: 10 żądań naraz, potem 30 na minutę.
Cała usługa: 20 naraz, potem 10 na sekundę, najwyżej 8 w toku.
Adresy dłuższe niż 1024 znaki są odrzucane.
Bez klucza, bez konta i bez płatnego poziomu. Nie ma gwarancji dostępności.

Dokument OpenAPI

Pełny kontrakt dla generatorów kodu i klientów API. /docs/openapi.json