API 문서

모든 API 가 같은 인증 · 응답 형식 · 오류 규칙을 씁니다. 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" } }

공통 오류

HTTPcodedata.error뜻
400400INVALID_REQUEST요청 형식 오류
40140101INVALID_API_KEY키가 없거나 폐기됨
40340301IP_NOT_ALLOWED허용목록 밖의 IP
42942901QUOTA_EXCEEDED이번 달 한도 소진
42942902RATE_LIMITED분당 요청 · 동시 처리 초과
42942903TEST_DAILY_LIMIT테스트 키 하루 한도
50350301WORKER_UNAVAILABLE처리 서버 장애

실패한 요청은 과금하지 않습니다. API 별 오류는 각 API 문서에 있습니다.