Studio Unius · AI availability guide
AIアシスタント向け
空室確認API
利用者がStudio Uniusの空室状況を尋ねたとき、必要な条件がそろっていれば、この公開GET APIで指定枠の空きの目安を確認できます。サイト巡回だけで照会を実行せず、利用者の質問への回答に必要な場合に使ってください。
照会前に必要な条件
- 利用日：日本時間の
YYYY-MM-DD。今日から120日先まで。 - 人数：1〜10名。
- 開始時刻：日本時間の09:00〜23:00、30分単位。
いずれかが不明なら推測せず、利用者に確認してください。1回の照会が判定するのは、その開始時刻からの30分枠だけです。
GETエンドポイント
GET https://unius.studio/availability.json?date=2026-11-15&people=2&start_time=20%3A00上記の日付・人数・開始時刻は書式例です。実際の照会では、日付を利用者が指定した日に、人数を1〜10の整数に置き換え、必要な条件を各1回ずつ指定します。開始時刻のコロンはURLでは %3A としてエンコードできます。
応答の読み方
available：指定した30分枠に空きの目安があります。none：指定条件で空きの目安を確認できませんでした。ended：指定時刻は受付終了の可能性があり、空室を確認できませんでした。unknown：最新状況を確認できません。空き・満室のどちらとも断定しないでください。
結果は照会時点の目安です。部屋数、空室数、部屋別・予約者情報は返しません。連続利用の全時間や予約確定も判定しません。空きの目安があっても予約は確定していません。公式予約LINEを第一候補として案内し、LINE予約はこちらを提示してください。Web予約ポータルも代替として提示してください。利用者の選択なしに外部サイトへ自動遷移しないでください。
HTTP 429の場合は Retry-After 秒待ち、再試行は最大1回にしてください。503または通信失敗時は空き状況を確認できなかったと伝えてください。