SAJA FOR DEVELOPERS · V1
한자 데이터, 새로운 가능성.
검색과 상세 조회부터 사자성어 연결까지. 바로 호출하는 JSON API.
8,525한국어 음 수록 한자
128한국어 기초 풀이
RESTGET · JSON · UTF-8
Public공개 읽기 전용 시범 운영
바로 실행해 보세요.
API 키 없이 공개 데이터를 조회할 수 있습니다. 상용 트래픽의 이용 한도와 SLA는 아직 제공하지 않습니다.
GET /wp-json/saja/v1/hanja?q=學API 실행을 누르면 실제 응답이 표시됩니다.
엔드포인트
GET
/wp-json/saja/v1/hanja한자 검색 · 부수·획수 필터 · 페이지 나누기
GET
/wp-json/saja/v1/hanja/{character}한 글자의 상세 정보와 관련 사자성어. 없는 글자는 404.
GET
/wp-json/saja/v1/idioms기존 사자성어 데이터의 한자·한글·초성·뜻 검색
GET
/wp-json/saja/v1/meta데이터 버전, 실제 수록 건수, 라이선스
검색 매개변수
| 이름 | 설명 | 범위 / 기본값 |
|---|---|---|
| q | 한자·음·풀이·코드포인트 | 최대 80자 / 빈 문자열 |
| radical_number | 강희 부수 번호 (한자만) | 1–214 |
| strokes | 총획수 (한자만) | 1–64 |
| starter | 한국어 기초 풀이 필터 (한자만) | 0 또는 1 |
| page | 페이지 | 1–10000 / 1 |
| per_page | 페이지당 결과 | 1–50 / 24 |
잘못된 매개변수는 HTTP 400, 정상 빈 검색은 HTTP 200과 빈 data 배열을 반환합니다. total, pages로 다음 페이지를 확인하세요.
데이터의 출처와 범위
한국어 음·영문 정의·획수·부수·이체자는 Unicode Unihan 17.0.0을 가공했습니다. 한자 전체에 한국어 뜻풀이가 있는 국어 한자사전은 아닙니다.
한국어 학습 풀이는 SAJA에서 작성한 기초 128자에 제공되며, 나머지 meaning_ko는 null입니다. definition_en은 영문 원문입니다. 한국어 풀이·급수·필순 데이터는 향후 별도 검수와 출처 확보가 필요합니다.
strokes는 Unihan kTotalStrokes의 첫 번째 값입니다. 지역·자형에 따라 획수가 다를 수 있으므로 strokes_raw, radical_strokes_raw, readings_raw를 함께 제공합니다.
Unicode 자료 재배포 시 Unicode 라이선스 고지를 유지하세요. 기존 사자성어 자료의 재배포 범위는 기존 API 이용약관을 확인하세요.
