Öppet API
Namngeneratorerna över HTTP. Gratis, utan nyckel och utan konto. Det använder aldrig AI och kan inte läsa någons projekt.
Endpoint
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
Parametrar
| Namn | Typ | Standard | Tillåtna värden |
|---|---|---|---|
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 | Heltal från 1 till 999,999 |
count | integer | 10 | Heltal från 1 till 20 |
Exempel
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'Prova
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'Svar
Ett JSON-objekt med version "1", den typ och det frö du bad om, namnen och adressen till generatorns sida. Samma typ och samma frö ger samma namn tills generatorns data ändras.
Fel
Fel besvaras med en HTTP-status och ett felobjekt med en stabil kod och ett läsbart meddelande. Vänta på Retry-After vid 429 och 503; försök inte andra fel om oförändrade.
| Status | Betydelse |
|---|---|
400 | En parameter har fel format eller ligger utanför intervallet. Rätta begäran innan du skickar den igen. |
405 | Bara GET och HEAD accepteras. |
408 | Begäran tog för lång tid att komma fram. |
413 | Begärans innehåll är större än 2 048 byte. |
414 | Adressen är längre än 1 024 tecken. |
415 | Innehållet är inte JSON. |
429 | För många begäranden från den här klienten. Vänta de sekunder som anges i Retry-After. |
500 | Något gick fel hos oss. Försök igen senare. |
503 | Tjänsten är upptagen. Vänta de sekunder som anges i Retry-After. |
Gränser
- Varje klient: 10 begäranden samtidigt, därefter 30 per minut.
- Hela tjänsten: 20 samtidigt, därefter 10 per sekund, högst 8 pågående.
- Adresser längre än 1 024 tecken avvisas.
- Ingen nyckel, inget konto och ingen betalnivå. Det finns ingen tillgänglighetsgaranti.
OpenAPI-dokument
Hela avtalet, för kodgeneratorer och API-klienter. /docs/openapi.json