비즈고 예약 api와 기술 문서 간의 차이

문의|Support
1

실제 예약 API와 기술 문서가 상이하다고 자사 개발자에게 요청받아 문의드립니다. 원문

기술되지 않은 필드가 반환됨

GET /api/comm/v1/reservation/resvKey/{resvKey}

문서(예시)에는 없는 resvData 필드가 반환됩니다.

POST /api/comm/v1/reservation

문서(예시)에는 없는 ref, data.destinations[] 필드들이 반환됩니다.

예약 목록 조회 — 월/일 단위 조회가 동작하지 않음

문서에는 resvSendTime이 필수이며 월/일/시각 단위로 조회할 수 있다고 되어 있습니다.

예시와 같이 resvSendTime=2026-05와 같이 월 단위로 조회해도 오류가 발생합니다:

2026-09 → A213 Invalid or empty 오류
2026-09-15 → A213 Invalid or empty 오류
2026-09-15 11:54:47 → 정상 동작
2

안녕하세요. 비즈고를 이용해 주셔서 감사합니다.:smiley:

전달해주신 예약기능 관련 예시 및
목록조회의 파라미터 지원사항들을 확인 후 조치하도록 하겠습니다.
(조치되면 댓글 다시 남기겠습니다.)

소중한 의견 전달해주셔서 감사합니다!:folded_hands:

3

혹시 예정일을 알 수 있을까요?

고객사에서 추석 이후에는 카카오톡 예약/취소 기능을 연동했으면 하시는데, 일자별 조회 기능이 지원되는지 여부가 중요해서요.

4

확인결과 기능적으로 현재
테스트하신대로 ‘yyyy-MM-dd HH:mm:ss’ 형태만 가능합니다.
잘못된 규격서로 혼선을 드려 죄송합니다.:sad_but_relieved_face:

예약 리스트의 조회 조건은 명시한 예약일시를 포함한 미래 시간으로 조회됩니다.

관련하여 금일 다른 기능(템플릿 리스트 조회)들과 함께
규격서 업데이트 하도록 하겠습니다.

감사합니다!

5

이 부분이 이해가 가질 않네요. resvSendTime 값을 전달하면 해당 일시(연월일시분초)에 예약된 메시지만 반환되는 게 아닌가요? limit 상방까지 미래에 예약된 모든 건을 반환하나요? 그렇다면 필수 인자가 아닌 limit의 기본값이 뭔지도 기술문서에 기술되어야 할 것 같습니다.

6

네, 해당 부분도 내용 추가하도록 하겠습니다.

현재는 limit이 min:1, max:1000 으로만 안내되어 있는데요.
입력하지 않을경우 Default: 100으로 되고 있습니다.

7

문의하신 기술되지 않은 필드 문의에 대한부분관련
예약 발송 및 예약 상세조회에 내용이 수정되었습니다.
참고 부탁드립니다. 감사합니다!:smiley: