Service

TableCheck

일본, 식당베타

Playground에서 시험 API 레퍼런스 열기

Overview

TableCheck 공개 음식점을 검색하고 예약 가능 여부를 확인하며, 계정을 연결해 비공개 프로필과 예약 정보를 조회합니다.

Status

정상

99.84%30일 가동률평균 응답348ms

Setup

Auth mode: 계정 연동
Credentials: tablecheck scope가 허용된 managed key
고객이 승인한 TableCheck 계정 연동
Sandbox: 미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

Method	API	Path	Summary
POST		/v1/tablecheck/cancel-reservation	확인 코드로 연결된 계정 소유의 실제 예약을 취소합니다. 파괴적인 PUT 전에 예약 상세 GET 한 번으로 소유권과 예약 식별자를 확인하며, 예약 범위의 401에는 계정 GET을 추가해 예약 존재 여부를 노출하지 않고 유효하지 않은 자격 증명을 구분합니다. 단 한 번의 PUT은 요청 본문을 보내지 않으며 그 결과는 요청한 코드와 일치해야 합니다. TableCheck가 예약이 이미 취소되었다고 응답하면 재시도 불가 오류 RESERVATION_ALREADY_CANCELLED로 실패합니다. 이 오퍼레이션은 멱등하지 않으며 항상 승인이 필요합니다.
POST		/v1/tablecheck/check-availability	하나의 매장, 매장 현지 날짜와 시간, 연령대별 인원 구성으로 TableCheck 익명 예약 위젯을 확인합니다. 특정 음식점과 원하는 시간이 이미 정해졌을 때 사용하세요. 예약을 생성·홀드·변경하는 용도로는 사용하지 말고 tablecheck:create-reservation-cart를 사용하세요. 근처의 다른 날짜와 시간을 둘러보는 용도로는 사용하지 말고 tablecheck:get-availability-timetable을 사용하세요. 최상위 status로 success, same_day, closed, disabled, preorder_required, service_category_required, unavailable, invalid_request, unknown 중 하나를 slots와 함께 반환합니다. preorder_required, service_category_required, unavailable, invalid_request, unknown 상태는 항상 빈 slots 배열을 반환하며, invalid_request에는 구조화된 invalid_reason이, unknown에는 diagnostic이 포함될 수 있습니다.
POST		/v1/tablecheck/confirm-reservation	유효한 TableCheck 카트와 호출자가 제공한 고객 정보로 실제이고 구속력 있는 음식점 예약을 생성합니다. create-reservation-cart가 반환한 cart_handle을 반환된 그대로 전달하세요. 누락된 고객 필드, 목적, 매장 질문, 서비스 카테고리, 메뉴 주문, 지원하지 않는 결제 수집, 그리고 이 프로바이더가 처리할 수 없는 기타 사전 조건은 제출 전에 거부합니다. 업스트림의 고객 정보 형식 오류에는 정규화된 필드 이름만 반환합니다. 현재 카트 상태가 승인된 핸들과 일치할 때만 확정을 진행합니다.
POST		/v1/tablecheck/create-reservation-cart	단기 TableCheck 예약 카트를 만듭니다. 매장은 정규화된 availability와 next_action 안내를 포함한 cart:null을 반환할 수 있으며, 예약 가능한 카트에만 핸들이 발급됩니다. 카트는 누락된 고객 필드, 고객 필드 입력 모드, 목적·질문 사전 조건, 결제 수집 지원 여부, nullable 메뉴 가격을 노출합니다. 호출자가 제공한 고객 정보와 목적 값은 프로바이더가 임의로 채우지 않고 제공된 그대로 전달하며, 답변 정의와 카트 echo는 개인 정보를 기록하지 않은 채 검증합니다.
POST		/v1/tablecheck/get-availability-timetable	하나의 매장, 시작 날짜와 연령대별 인원 구성으로 TableCheck 익명 시간표를 조회합니다. 호출자가 요청 시간을 바꿀 수 있고 근처의 예약 가능한 날짜와 시간을 보고 싶을 때 사용하세요. 특정 시각 하나를 확인하는 용도로는 사용하지 말고 tablecheck:check-availability를 사용하세요. 예약을 생성하거나 홀드하는 용도로는 사용하지 말고 tablecheck:create-reservation-cart를 사용하세요. 최상위에 날짜별로 묶인 매장 현지 슬롯, HH:MM 시간 범위, 매장 시간대를 반환합니다. 지원하지 않는 시간표 응답은 빈 배열과 선택적 정규화 diagnostic으로 나타냅니다.

Related guides

key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.
멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.