OPEN API · v1 · 사자성어 910개
사자성어를
사자성어를
JSON 한 번으로
내 서비스에.
한국어 사자성어 데이터와 자동 생성 퀴즈를 REST API로 제공합니다. 키 없이 바로 테스트하고, 연 9,900원으로 퀴즈 앱·챗봇·학습 서비스를 만들어 보세요.
0
사자성어
0
퀴즈 유형
30/일
무료 호출
9,900원
연간 이용
# 정답까지 담긴 4지선다 퀴즈 $ curl "https://www.sajaquiz.com/wp-json/sajaquiz/api/v1/quiz" 로딩 중…
QUICK START
5분 만에 시작
회원가입도, SDK 설치도 필요 없습니다. GET 요청 한 줄이면 끝. 키 없이 IP당 하루 30회까지 무료로 테스트할 수 있어요.
01
호출하기
Base URL에 /quiz를 붙여 GET 요청을 보냅니다.
02
응답 받기
문제·보기·정답이 담긴 JSON이 즉시 반환됩니다.
03
채점하기
answer 필드로 사용자의 선택을 바로 채점하세요.
# Base URL
https://www.sajaquiz.com/wp-json/sajaquiz/api/v1/
PLAYGROUND
직접 호출해 보기
엔드포인트와 파라미터를 고르고 실행을 누르면 실제 API를 호출해 응답을 그대로 보여줍니다. 발급받은 키가 있다면 입력해 보세요.
GET
/quiz
▶ 실행을 눌러 응답을 확인하세요.
API REFERENCE
엔드포인트
인증은 헤더 X-API-Key 또는 쿼리 ?api_key=. 생략 시 무료 데모로 동작합니다.
GET/quiz랜덤 퀴즈 생성
사자성어 퀴즈를 자동 생성합니다. 보기는 무작위 오답과 함께 구성되며 정답이 포함됩니다.
| type | 퀴즈 유형 — meaning_to_idiom(뜻→성어) · idiom_to_meaning(성어→뜻) · hangul_to_hanja(한글→한자). 생략 시 랜덤 |
| choices | 보기 개수 (2~6, 기본 4) |
| count | 한 번에 받을 퀴즈 수 (1~20, 기본 1) |
GET/idiom랜덤 원본 데이터
사자성어 원본(한자·한글·초성·뜻)을 반환합니다.
| count | 개수 (1~50, 기본 1) |
GET/idiom/{idx}단건 조회
특정 사자성어 1건을 idx로 조회합니다. 예:
https://www.sajaquiz.com/wp-json/sajaquiz/api/v1/idiom/2GET/search검색
한자·한글·뜻으로 검색합니다 (최대 30건).
| q | 검색어 (필수) |
GET/me키 상태
현재 키의 플랜·상태·오늘 사용량·만료일을 반환합니다.
POST/subscribe연간 신청
연간 이용권을 신청하고 키를 발급받습니다. JSON 바디:
| name | 이름/상호 (필수) |
| 이메일 (필수) | |
| phone | 연락처 |
| depositor | 입금자명 |
RESPONSE
퀴즈 JSON 구조
정답(answer)과 정답 상세(answer_idiom)가 함께 와서 채점 로직을 바로 구현할 수 있습니다.
{
"success": true,
"quiz": {
"quiz_id": "q2m3f9a1",
"type": "meaning_to_idiom",
"question": "다음 뜻에 해당하는 사자성어는?",
"prompt": "작은 사건이 큰 파장을 일으킨다",
"choices": [
{ "key":"1", "text":"一波萬波", "hangul":"일파만파" }
],
"answer": "1",
"answer_idiom": {
"idx":2, "hanja":"一波萬波",
"hangul":"일파만파", "chosung":"ㅇㅍㅁㅍ",
"meaning":"작은 사건이 큰 파장을 일으킨다"
}
},
"quota": { "plan":"annual", "remaining":9988 }
}
quiz_id퀴즈 고유 IDtype퀴즈 유형question문제 안내 문구prompt실제 제시어(뜻/성어/한글)choices[]보기 목록. key=번호, text=표시값answer정답 보기의 keyanswer_idiom정답 사자성어 전체 정보quota플랜·잔여 호출 수EXAMPLES
코드 예제
발급받은 키를 넣어 바로 연동하세요.
curl -H "X-API-Key: 발급받은키" \ "https://www.sajaquiz.com/wp-json/sajaquiz/api/v1/quiz?count=5"
PRICING
부담 없는 단일 요금
복잡한 등급은 없습니다. 무료로 충분히 써보고, 필요하면 연 9,900원으로 1년간.
GET STARTED
키 발급 신청 — 연 9,900원
신청 즉시 키가 발급되어 무료 한도(100/일)로 바로 테스트할 수 있고, 입금이 확인되면 1년 이용권으로 자동 전환됩니다.
💳 무통장 입금 안내
은행국민은행
계좌번호642001-04-284588
예금주문호영(티온)
결제 금액9,900원
이용 기간1년
입금자명을 신청서와 동일하게 적어주시면 확인이 빠릅니다. 입금 확인 후 영업일 기준 신속히 활성화됩니다.
FAQ
자주 묻는 질문
키 없이도 쓸 수 있나요?
네. 키 없이 호출하면 IP 기준 하루 30회까지 무료 데모로 동작합니다. 운영 서비스에는 연간 이용권을 권장합니다.
결제는 어떻게 하나요?
무통장 입금만 지원합니다. 신청 후 안내된 국민은행 계좌로 9,900원을 입금하시면 확인 후 1년 이용권이 활성화됩니다.
정답도 같이 받을 수 있나요?
네.
/quiz 응답에 answer(정답 번호)와 answer_idiom(정답 상세)이 포함되어, 직접 채점 로직을 구현할 수 있습니다.상업적으로 사용해도 되나요?
연간 이용권은 상업적 이용이 가능합니다. 단, 데이터 전체를 그대로 재판매하거나 동일 API를 복제·재판매하는 행위는 금지됩니다(약관 참조).
세금계산서 발행이 되나요?
티온(사업자등록번호 621-42-00020) 명의로 발행 가능합니다. a@tion.kr 로 요청해 주세요.