営業時間API（Business Hours API）の使い方

必要なスコープ

アプリ編集画面の「APIスコープ」でチェックを入れたうえで、認可URLの scope パラメータに含めてください。

認証

他のv1 APIと同じトークン規約です。

• ビジネスアカウントに紐付いたトークン — そのまま呼び出せます
• ユーザースコープのトークン（ネイティブモバイルアプリ向け） — クエリに ?organizationId= を付与してください

エンドポイント一覧

営業時間と就業可能時間の違い

• 営業時間 — お客様向けに公開する開店・閉店時間。曜日ごとに複数の時間帯（昼営業・夜営業など）を登録できます
• 就業可能時間 — シフトを作成できる時間の上限となる業務時間。開店前の仕込みや閉店後の片付けを含めた範囲を設定します

シフト管理機能やシフト作成APIは、就業可能時間の範囲内でのみシフトを登録できます。

就業可能時間の設定

PUT /api/v1/stores/{storeId}/business-hours/work-hours-limit
Authorization: Bearer {token}
Content-Type: application/json

{
  "standardWorkStartTime": "08:00",
  "standardWorkEndTime": "23:00"
}

時刻は HH:mm 形式で指定し、開始は終了より前である必要があります。両方を空文字にすると制限なし（24時間シフト登録可）になります。

特例営業日の登録

PUT /api/v1/stores/{storeId}/business-hours/special-days/2026-08-13
Authorization: Bearer {token}
Content-Type: application/json

{
  "isClosed": true,
  "note": "夏季休業"
}

臨時休業のほか、特定日だけ営業時間を変更する登録もできます。open-status の判定は特例営業日を優先して評価します。

関連ガイド

• API認証ガイド（OAuth 2.0 認可コードフロー）
• OAuthスコープ一覧と利用可否
• 予約管理API（Reservations API）の使い方
• 従業員管理API（Staff API）の使い方