API 문서
모든 API 가 같은 인증 · 응답 형식 · 오류 규칙을 씁니다. API 별 사용법은 아래 목록에서 고르세요.
문서 처리 한글 문서 추출 HWP · HWPX 문서를 구조 그대로 JSON 과 Markdown 으로
POST /v1/extract물류 택배 조회 송장번호로 배송 상태와 이동 경로를 한 번에 준비 중티켓 티켓 발권 공연 · 행사 티켓을 발권하고 관리 준비 중티켓 좌석 예매 좌석 배치도 기반 예매 · 선점 · 확정 준비 중리워드 포인트 · 마일리지 적립 · 사용 · 취소 · 소멸까지 포인트 장부를 API 로 준비 중트래픽 동시접속 트래픽 관리 이벤트 · 오픈 때 몰리는 접속을 대기열로 차례대로 준비 중인증
앱 화면에서 받은 키를 Authorization 헤더에 넣습니다. 쿼리 문자열로 키를 보내지 마세요.
Authorization: Bearer cx_live_… # 라이브
Authorization: Bearer cx_test_… # 테스트 (과금 없음 · 하루 한도) 응답 형식
모든 응답은 같은 봉투에 담깁니다. code 는 숫자이고, 실패하면 data.error 에 영문 오류 이름이 들어갑니다.
{ "mode": true, "code": 200, "message": null, "data": { … } }
{ "mode": false, "code": 42901, "message": "이번 달 플랜 한도를 모두 사용했습니다.",
"data": { "error": "QUOTA_EXCEEDED" } } 공통 오류
| HTTP | code | data.error | 뜻 |
|---|---|---|---|
| 400 | 400 | INVALID_REQUEST | 요청 형식 오류 |
| 401 | 40101 | INVALID_API_KEY | 키가 없거나 폐기됨 |
| 403 | 40301 | IP_NOT_ALLOWED | 허용목록 밖의 IP |
| 429 | 42901 | QUOTA_EXCEEDED | 이번 달 한도 소진 |
| 429 | 42902 | RATE_LIMITED | 분당 요청 · 동시 처리 초과 |
| 429 | 42903 | TEST_DAILY_LIMIT | 테스트 키 하루 한도 |
| 503 | 50301 | WORKER_UNAVAILABLE | 처리 서버 장애 |
실패한 요청은 과금하지 않습니다. API 별 오류는 각 API 문서에 있습니다.