DoctorNestDevelopers

개발자 포털문서

API 레퍼런스

상품을 조회하고, 가능한 시간을 골라 예약을 생성하세요. 공개 샌드박스는 가상 상품과 고정된 시간표로 동작합니다.

이 페이지에서
OpenAPI 명세 다운로드 YAML

API 실행

아래에서 요청을 보내면 샌드박스의 실제 HTTP 상태와 JSON 응답이 표시됩니다. 생성한 예약은 병원 일정에 반영되지 않습니다.

샌드박스인증 없이 실행
GET/sandbox/v1/catalog/items

상품 목록

GET/sandbox/v1/catalog/items

items는 상품 ID, 이름, 소요 시간(분)의 배열입니다. 선택한 id를 시간 조회의 itemId와 위젯 버튼의 data-item-id에 사용하세요.

cURL
curl 'https://developers.doctornest.ai/sandbox/v1/catalog/items'

예약 가능 시간

GET/sandbox/v1/availability
가능 시간 쿼리 파라미터
쿼리필수설명
itemId필수상품 목록에서 받은 상품 ID
date필수한국 시간 기준 날짜. YYYY-MM-DD 형식이며 2000~2099년의 유효한 날짜를 지원합니다.

응답의 timeZone은 Asia/Seoul입니다. slots에서 available이 true인 시간만 선택하고, 해당 슬롯의 id를 보관하세요.

cURL
curl 'https://developers.doctornest.ai/sandbox/v1/availability?itemId=consult&date=2026-12-07'

예약 생성

POST/sandbox/v1/bookings

Content-Type: application/json 헤더와 함께, 시간 조회에서 받은 slotId를 보냅니다. 이름·전화번호를 입력할 필요가 없습니다.

cURL
curl -X POST 'https://developers.doctornest.ai/sandbox/v1/bookings' \
  -H 'Content-Type: application/json' \
  -d '{"slotId":"consult.2026-12-07.1000"}'

성공하면 HTTP 200과 예약번호 booking.id, 확정 상태 confirmed, sandbox: true를 반환합니다. 같은 슬롯을 다시 요청하면 같은 예약번호가 반환됩니다.

오류 응답

응답의 error.code로 원인을 구분하고 error.message에서 설명을 확인하세요.

HTTP 상태와 해결 방법
HTTP코드확인할 내용
400invalid_request날짜, 필수 값, JSON 형식을 확인하세요.
404not_found상품이나 슬롯 ID를 다시 조회하세요.
409slot_full마감된 슬롯입니다. 가능한 시간을 다시 선택하세요.
413payload_too_large예약 요청 본문을 4 KiB 이내로 보내세요.
415unsupported_media_typeContent-Type을 application/json으로 지정하세요.