公開API
HTTPで使える名前ジェネレーターです。無料で、キーもアカウントも不要です。AIは使わず、他人のプロジェクトを読むこともできません。
エンドポイント
GEThttps://musael.com/api/public/v1/names
Generate up to 20 names using one of 24 deterministic generators, without AI or account access.
パラメーター
| 名前 | 型 | デフォルト | 使用できる値 |
|---|---|---|---|
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から999,999までの整数 |
count | integer | 10 | 1から20までの整数 |
例
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=3'試してみる
curl 'https://musael.com/api/public/v1/names?kind=elf&seed=42&count=5'レスポンス
バージョン"1"、リクエストした種類とシード、名前、ジェネレーターのページのアドレスを含むJSONオブジェクトです。種類とシードが同じなら、ジェネレーターのデータが変わるまで同じ名前が返ります。
エラー
エラーは、HTTPステータスと、固定のコードと読みやすいメッセージを持つエラーオブジェクトで返ります。429と503ではRetry-Afterの秒数だけ待ってください。それ以外のエラーはそのまま再試行しないでください。
| ステータス | 意味 |
|---|---|
400 | パラメーターの形式が正しくないか、範囲外です。リクエストを修正してから再送してください。 |
405 | GETとHEADのみ受け付けます。 |
408 | リクエストの到着に時間がかかりすぎました。 |
413 | リクエスト本文が2,048バイトを超えています。 |
414 | アドレスが1,024文字を超えています。 |
415 | 本文がJSONではありません。 |
429 | このクライアントからのリクエストが多すぎます。Retry-Afterの秒数だけ待ってください。 |
500 | こちら側で問題が発生しました。しばらくしてからもう一度お試しください。 |
503 | サービスが混み合っています。Retry-Afterの秒数だけ待ってください。 |
制限
- クライアントごと：同時に10リクエスト、その後は1分あたり30リクエスト。
- サービス全体：同時に20、その後は1秒あたり10、処理中は最大8。
- 1,024文字を超えるアドレスは受け付けません。
- キーもアカウントも有料プランもありません。可用性は保証されません。
OpenAPIドキュメント
コードジェネレーターやAPIクライアント向けの完全な仕様です。 /docs/openapi.json