Herkese açık API

HTTP üzerinden ad oluşturucular. Ücretsiz; anahtar ve hesap gerekmez. YZ kullanmaz ve kimsenin projesini okuyamaz.

Uç nokta

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

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

Parametreler

Ad	Tür	Varsayılan	İzin verilen değerler
`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`	1 ile 999,999 arasında tam sayı
`count`	integer	`10`	1 ile 20 arasında tam sayı

Örnek

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

Dene

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

Yanıt

"1" sürümünü, istediğin türü ve tohumu, adları ve oluşturucu sayfasının adresini içeren bir JSON nesnesi. Aynı tür ve aynı tohum, oluşturucunun verisi değişene kadar aynı adları verir.

Hatalar

Hatalar, bir HTTP durumu ve sabit bir kod ile okunabilir bir mesaj içeren hata nesnesiyle yanıtlanır. 429 ve 503'te Retry-After süresini bekle; diğer hataları olduğu gibi yeniden deneme.

Durum	Anlamı
`400`	Bir parametrenin biçimi eksik ya da aralığın dışında. İsteği düzeltip yeniden gönder.
`405`	Yalnızca GET ve HEAD kabul edilir.
`408`	İstek ulaşmak için çok uzun sürdü.
`413`	İstek gövdesi 2.048 bayttan büyük.
`414`	Adres 1.024 karakterden uzun.
`415`	Gövde JSON değil.
`429`	Bu istemciden çok fazla istek geldi. Retry-After'daki saniye kadar bekle.
`500`	Bizim tarafımızda bir şey ters gitti. Daha sonra tekrar dene.
`503`	Hizmet meşgul. Retry-After'daki saniye kadar bekle.

Sınırlar

Her istemci: aynı anda 10 istek, sonra dakikada 30.
Tüm hizmet: aynı anda 20, sonra saniyede 10, en çok 8 işlemde.
1.024 karakterden uzun adresler reddedilir.
Anahtar yok, hesap yok, ücretli katman yok. Erişilebilirlik garantisi yoktur.

OpenAPI belgesi

Kod oluşturucular ve API istemcileri için tam sözleşme. /docs/openapi.json