공개 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개, 그다음 분당 30개예요.
- 전체 서비스: 동시에 20개, 그다음 초당 10개, 처리 중 최대 8개예요.
- 1,024자보다 긴 주소는 거부돼요.
- 키도, 계정도, 유료 단계도 없어요. 가용성은 보장하지 않아요.
OpenAPI 문서
코드 생성기와 API 클라이언트를 위한 전체 명세예요. /docs/openapi.json