公開API（読み取り専用）
Public read-only API for AI agents and integrations
予約Liteの店舗ページの情報（メニュー・料金・空き枠）を取得できます。認証は不要です。 予約の確定はAPIでは行えません。お客様を店舗の予約ページ https://yoyakulite.com/book/{slug} へ案内してください。
- OpenAPI 3.1: https://yoyakulite.com/openapi.json
- API catalog (RFC 9727): https://yoyakulite.com/.well-known/api-catalog
- 時刻はすべて ISO 8601（UTC）。店舗のタイムゾーン（例：Asia/Tokyo）を併せて返します。料金は税込（円）。
GET /api/stores/{slug}
店舗名・受付状況・キャンセル期限と、予約できるメニュー（所要時間・税込料金・オプション）を返します。slug は予約ページURLの末尾です。
curl https://yoyakulite.com/api/stores/demo-salonGET /api/availability/month?slug=&serviceId=&month=YYYY-MM
指定メニューの、日ごとの空き枠数を返します。オプションを付ける場合は options=id1,id2（所要時間が延びるため空きが変わります）。
curl "https://yoyakulite.com/api/availability/month?slug=demo-salon&serviceId=<services[].id>&month=2026-10"GET /api/availability?slug=&serviceId=&date=YYYY-MM-DD
指定日の予約可能な開始時刻（slots）を返します。受付停止中は error: "paused" が付きます。
curl "https://yoyakulite.com/api/availability?slug=demo-salon&serviceId=<services[].id>&date=2026-10-01"GET /api/version
稼働中のバージョン（ヘルスチェック）。
curl https://yoyakulite.com/api/versionエラー
400 bad_request（パラメータ不足・形式違い）、400 unknown_option、404 not_found（店舗なし）、404 service_not_found。本文は {"error": "..."} です。
利用について
店舗様の営業を妨げる大量アクセスはお控えください。予約の代行・自動確定には対応していません。お問い合わせは 特定商取引法に基づく表記 の連絡先まで。