{"openapi":"3.1.0","info":{"title":"予約手帳 Reserve Note — AI エージェント向け予約受付 API","version":"1.0.0","description":"お店やご事業の空き時間を読み、仮押さえ → 確定 の二段で予約を入れます。仮押さえは 15 分で失効します。同じ idempotencyKey を二度送っても予約は一件だけです。確定のときに返る manageKey は、利用者本人に必ず伝えてください。"},"servers":[{"url":"https://bonds.advisers.jp/api/bff"}],"paths":{"/public/reserve/directory":{"get":{"operationId":"listVenues","summary":"受け付けているお店の一覧 (公開しているものだけ)","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"名前・住所・説明での絞り込み"},{"name":"kind","in":"query","schema":{"type":"string","enum":["restaurant","salon","clinic","other"]}}],"responses":{"200":{"description":"一覧"}}}},"/public/reserve/{venueKey}":{"get":{"operationId":"getVenue","summary":"お店の情報・受付時間・決まり","parameters":[{"name":"venueKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"お店の情報"},"404":{"description":"見つからない"}}}},"/public/reserve/{venueKey}/availability":{"get":{"operationId":"getAvailability","summary":"予約できる開始時刻の一覧","parameters":[{"name":"venueKey","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"既定は今日"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"既定は from の 14 日後 (最長 31 日)"}],"responses":{"200":{"description":"空き","content":{"application/json":{"schema":{"type":"object","properties":{"slots":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"remaining":{"type":"integer","description":"その時刻にまだ受けられる件数"}}}}}}}}}}}},"/public/reserve/{venueKey}/holds":{"post":{"operationId":"createHold","summary":"仮押さえ (15 分)。確定は confirm で","parameters":[{"name":"venueKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["start","guestName"],"properties":{"start":{"type":"string","format":"date-time","description":"availability の slot.start をそのまま"},"partySize":{"type":"integer","default":1},"guestName":{"type":"string"},"guestContact":{"type":"string","description":"メールか電話。お店からの連絡に使う"},"guestNote":{"type":"string"},"idempotencyKey":{"type":"string","description":"同じ依頼を二度受けないための一意な ID"},"agent":{"type":"string","description":"エージェントの名乗り (任意)"}}}}}},"responses":{"201":{"description":"仮押さえ","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["hold","pending","confirmed","canceled","expired","no_show","done"]},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"partySize":{"type":"integer"},"manageKey":{"type":"string","description":"確認と取り消しに使う鍵。利用者に必ず伝える"},"manageUrl":{"type":"string","format":"uri"},"holdExpiresAt":{"type":"string","format":"date-time","nullable":true}}}}}}}},"400":{"description":"入力の不備"},"409":{"description":"その時刻は空いていない"}}}},"/public/reserve/{venueKey}/holds/{holdId}/confirm":{"post":{"operationId":"confirmHold","summary":"仮押さえを確定する","parameters":[{"name":"venueKey","in":"path","required":true,"schema":{"type":"string"}},{"name":"holdId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"確定 (お店が確かめる設定のときは status=pending)","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["hold","pending","confirmed","canceled","expired","no_show","done"]},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"partySize":{"type":"integer"},"manageKey":{"type":"string","description":"確認と取り消しに使う鍵。利用者に必ず伝える"},"manageUrl":{"type":"string","format":"uri"},"holdExpiresAt":{"type":"string","format":"date-time","nullable":true}}}}}}}},"410":{"description":"仮押さえが失効した"}}}},"/public/reserve/{venueKey}/bookings/{manageKey}":{"get":{"operationId":"getBooking","summary":"予約の確認 (manageKey で)","parameters":[{"name":"venueKey","in":"path","required":true,"schema":{"type":"string"}},{"name":"manageKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"予約"},"404":{"description":"見つからない"}}}},"/public/reserve/{venueKey}/bookings/{manageKey}/cancel":{"post":{"operationId":"cancelBooking","summary":"予約の取り消し (manageKey で)","parameters":[{"name":"venueKey","in":"path","required":true,"schema":{"type":"string"}},{"name":"manageKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"取り消した (無料かどうかを添える)"},"404":{"description":"見つからない"}}}}}}