개요
제약 CSO 업무용 REST API 마켓플레이스입니다. 계정당 API 키를 발급받아 각 API를 호출합니다. API별 상세 스펙은 좌측 API 레퍼런스에서 확인하세요.
시작하기
- 회원가입 후 로그인합니다.
- 대시보드 → API 키에서 키(
pk_live_…)를 발급합니다. 발급 시 한 번만 표시되니 안전하게 보관하세요. - 좌측 API 레퍼런스에서 원하는 API의 엔드포인트·요청·응답을 확인하고 호출합니다.
인증
모든 요청에 API 키를 헤더로 전달합니다. 키가 없거나 무효면 401이 반환됩니다.
x-api-key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxx과금
- 성공 호출당 API별 단가가 과금됩니다(계정×API별 무료 제공량 소진 후).
- 실패(5xx) 호출은 과금되지 않습니다(자동 환불).
- 무료 제공량을 초과하고 잔액이 부족하면
402가 반환되며, 대시보드의 사용 신청으로 유료 사용을 신청할 수 있습니다. - 가격은 변경될 수 있으며, 각 호출은 호출 시점 단가로 과금·기록됩니다.
공통 에러
에러 응답 본문: { "error": "<code>", "message"?: "..." }
| HTTP | error | 의미 |
|---|---|---|
401 | invalid_key | API 키 누락 또는 무효/폐기 |
403 | not_entitled | 해당 API 사용 권한 없음 |
402 | insufficient_credit | 무료 소진 + 잔액 부족 (applyUrl 포함) |
404 | product_not_found | 존재하지 않거나 종료된 API |
422 | bad_image | 요청 본문/이미지 해석 불가 |
429 | rate_limited | 요청 한도 초과 |
502 | processor_error | 처리 백엔드 오류 (해당 호출 자동 환불) |
출처: 건강보험심사평가원, 공공누리 제1유형