{"openapi":"3.1.0","info":{"title":"bibibi 公開 API","version":"1.0.0","description":"認証不要の読み取り専用API。公開済みの店舗の事実のみ。キャスト情報・写真・個人情報は含みません。open_now は営業時間による判定で、予約空き状況ではありません。as_of / generated_at は分単位。事実のCDNキャッシュは1時間（stale-while-revalidate=86400秒）。now（今すぐ行けるか）を含む応答は60秒。now.level=A は予約台帳から計算した実際の空き（キャストの名前・写真・予約内容は含めない）。IPごとに120回/分を目安に制限。公開前は全エンドポイント404。","license":{"name":"出典（bibibiのURL）と確認日時の併記を条件に無料・再配布可"}},"servers":[{"url":"https://bi-bi-bi.jp"}],"security":[],"paths":{"/api/public/v1/areas":{"get":{"operationId":"listAreas","summary":"都道府県・エリア・駅と公開店舗数","parameters":[{"name":"pref","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"},"description":"都道府県スラッグ。未指定は全都道府県。準備中のエリアは件数0。"},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"前回の ETag。合致時は 304。"}],"responses":{"200":{"description":"公開情報","headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}},"Access-Control-Allow-Origin":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PrefAreas"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"$ref":"#/components/schemas/Links"}},"additionalProperties":false}}}},"304":{"description":"変更なし。本文なし。","headers":{"ETag":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/InvalidParam"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}},"options":{"summary":"CORS プリフライト","responses":{"204":{"description":"GET, OPTIONS を全オリジンに許可"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/public/v1/shops":{"get":{"operationId":"searchShops","summary":"店舗の事実を検索","parameters":[{"name":"pref","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"},"description":"都道府県スラッグ。pref または station のいずれかが必須。"},{"name":"area","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"},"description":"エリアスラッグ"},{"name":"station","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"},"description":"駅スラッグ。pref と組み合わせて絞り込み可能。"},{"name":"open_now","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"営業時間上、基準日時に営業中の店舗に絞る。"},{"name":"now","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"予約台帳上、今から60分以内に始められる枠がある店舗（今すぐ案内可）に絞る。"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90071992547409,"default":1},"description":"ページ番号"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"1ページの件数"},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"前回の ETag。合致時は 304。"}],"responses":{"200":{"description":"公開情報","headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}},"Access-Control-Allow-Origin":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ShopFact"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"$ref":"#/components/schemas/Links"}},"additionalProperties":false}}}},"304":{"description":"変更なし。本文なし。","headers":{"ETag":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/InvalidParam"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}},"description":"今すぐ案内可（次に空くまでの分が短い順）、次に空く時刻がある店、営業中、開店前、その他の順。続いて確認日時の新しい順、情報量、slug順。meta.count は絞り込み後の総数。未知・重複パラメータは400。"},"options":{"summary":"CORS プリフライト","responses":{"204":{"description":"GET, OPTIONS を全オリジンに許可"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/public/v1/shops/{slug}":{"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"},"description":"店舗スラッグ"}],"get":{"operationId":"getShop","summary":"店舗の事実・拠点・出典","parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"前回の ETag。合致時は 304。"}],"responses":{"200":{"description":"公開情報","headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}},"Access-Control-Allow-Origin":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links"],"properties":{"data":{"$ref":"#/components/schemas/ShopDetail"},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"$ref":"#/components/schemas/Links"}},"additionalProperties":false}}}},"304":{"description":"変更なし。本文なし。","headers":{"ETag":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/InvalidParam"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}},"options":{"summary":"CORS プリフライト","responses":{"204":{"description":"GET, OPTIONS を全オリジンに許可"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/public/v1/shops/{slug}/availability":{"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,99}$"},"description":"店舗スラッグ"}],"get":{"operationId":"getAvailability","summary":"今すぐ行けるか（予約台帳連動・60秒キャッシュ）","parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"前回の ETag。合致時は 304。"}],"responses":{"200":{"description":"公開情報","headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}},"Access-Control-Allow-Origin":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links"],"properties":{"data":{"$ref":"#/components/schemas/Availability"},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"$ref":"#/components/schemas/Links"}},"additionalProperties":false}}}},"304":{"description":"変更なし。本文なし。","headers":{"ETag":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/InvalidParam"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}},"options":{"summary":"CORS プリフライト","responses":{"204":{"description":"GET, OPTIONS を全オリジンに許可"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/public/v1/openapi.json":{"get":{"operationId":"getOpenApi","summary":"OpenAPI 3.1仕様","parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"前回の ETag。合致時は 304。"}],"responses":{"200":{"description":"公開情報","headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}},"Access-Control-Allow-Origin":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["openapi","info","paths"]}}}},"304":{"description":"変更なし。本文なし。","headers":{"ETag":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/InvalidParam"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}},"options":{"summary":"CORS プリフライト","responses":{"204":{"description":"GET, OPTIONS を全オリジンに許可"},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"responses":{"InvalidParam":{"description":"パラメータが不正","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"公開前、非公開店舗、または該当なし","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"レート制限","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"再試行までの秒数"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"公開情報を一時的に取得できない","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Meta":{"type":"object","required":["as_of","generated_at","count","page","per_page","attribution","license"],"properties":{"as_of":{"type":"string","format":"date-time"},"generated_at":{"type":"string","format":"date-time"},"count":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"per_page":{"type":"integer","minimum":0},"attribution":{"type":"string"},"license":{"type":"string"}},"additionalProperties":false},"Links":{"type":"object","required":["self","next"],"properties":{"self":{"type":"string","format":"uri"},"next":{"type":["string","null"],"format":"uri"}},"additionalProperties":false},"ShopFact":{"type":"object","required":["slug","name","url","pref","area","station","shop_type","address","phone","line_url","website_url","business_hours","reception_hours","price_min","features","open_now","now","booking_url","source","confidence","verified_at","as_of"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"pref":{"type":["object","null"],"required":["slug","name"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}},"additionalProperties":false},"area":{"type":["object","null"],"required":["slug","name"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}},"additionalProperties":false},"station":{"type":["object","null"],"required":["slug","name","exit","walk_minutes","lat","lng"],"properties":{"slug":{"type":["string","null"]},"name":{"type":"string"},"exit":{"type":["string","null"]},"walk_minutes":{"type":["number","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]}},"additionalProperties":false},"shop_type":{"type":["string","null"],"enum":["store","room","dispatch",null]},"address":{"type":["string","null"],"description":"店舗が公開を許可した住所のみ"},"phone":{"type":["string","null"]},"line_url":{"type":["string","null"],"format":"uri"},"website_url":{"type":["string","null"],"format":"uri"},"business_hours":{"type":["object","null"],"required":["start","end","crosses_midnight"],"properties":{"start":{"type":"string"},"end":{"type":"string"},"crosses_midnight":{"type":"boolean"}},"additionalProperties":false},"reception_hours":{"type":["string","null"]},"price_min":{"type":["object","null"],"required":["minutes","yen"],"properties":{"minutes":{"type":["number","null"]},"yen":{"type":"number"}},"additionalProperties":false},"features":{"type":"array","items":{"type":"string"}},"open_now":{"type":"boolean","description":"営業時間から判定。予約空き状況を表すものではありません。as_of 時点の値。"},"now":{"anyOf":[{"$ref":"#/components/schemas/Now"},{"type":"null"}],"description":"今すぐ行けるか。level A は店舗の予約台帳と連動、C は営業時間のみ。60 秒キャッシュ。"},"booking_url":{"type":["string","null"],"format":"uri"},"source":{"type":["string","null"],"enum":["booking_ledger","official_site","directory","shop_provided","editorial",null]},"confidence":{"type":["number","null"],"minimum":0,"maximum":1},"verified_at":{"type":["string","null"],"format":"date-time"},"as_of":{"type":"string","format":"date-time","description":"営業時間判定の基準日時。分単位の精度。"}},"additionalProperties":false},"ShopDetail":{"type":"object","required":["slug","name","url","pref","area","station","shop_type","address","phone","line_url","website_url","business_hours","reception_hours","price_min","features","open_now","now","booking_url","source","confidence","verified_at","as_of","rooms","sources","description"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"pref":{"type":["object","null"],"required":["slug","name"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}},"additionalProperties":false},"area":{"type":["object","null"],"required":["slug","name"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}},"additionalProperties":false},"station":{"type":["object","null"],"required":["slug","name","exit","walk_minutes","lat","lng"],"properties":{"slug":{"type":["string","null"]},"name":{"type":"string"},"exit":{"type":["string","null"]},"walk_minutes":{"type":["number","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]}},"additionalProperties":false},"shop_type":{"type":["string","null"],"enum":["store","room","dispatch",null]},"address":{"type":["string","null"],"description":"店舗が公開を許可した住所のみ"},"phone":{"type":["string","null"]},"line_url":{"type":["string","null"],"format":"uri"},"website_url":{"type":["string","null"],"format":"uri"},"business_hours":{"type":["object","null"],"required":["start","end","crosses_midnight"],"properties":{"start":{"type":"string"},"end":{"type":"string"},"crosses_midnight":{"type":"boolean"}},"additionalProperties":false},"reception_hours":{"type":["string","null"]},"price_min":{"type":["object","null"],"required":["minutes","yen"],"properties":{"minutes":{"type":["number","null"]},"yen":{"type":"number"}},"additionalProperties":false},"features":{"type":"array","items":{"type":"string"}},"open_now":{"type":"boolean","description":"営業時間から判定。予約空き状況を表すものではありません。as_of 時点の値。"},"now":{"anyOf":[{"$ref":"#/components/schemas/Now"},{"type":"null"}],"description":"今すぐ行けるか。level A は店舗の予約台帳と連動、C は営業時間のみ。60 秒キャッシュ。"},"booking_url":{"type":["string","null"],"format":"uri"},"source":{"type":["string","null"],"enum":["booking_ledger","official_site","directory","shop_provided","editorial",null]},"confidence":{"type":["number","null"],"minimum":0,"maximum":1},"verified_at":{"type":["string","null"],"format":"date-time"},"as_of":{"type":"string","format":"date-time","description":"営業時間判定の基準日時。分単位の精度。"},"rooms":{"type":"array","items":{"$ref":"#/components/schemas/Room"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"description":{"type":["string","null"]}},"additionalProperties":false},"Now":{"type":"object","required":["level","ledger_linked","available_now","next_start","minutes_until","on_shift","open_now","biz_date","as_of"],"properties":{"level":{"type":["string","null"],"enum":["A","C",null],"description":"A=予約台帳連動の空き、C=営業時間のみ、null=営業時間外"},"ledger_linked":{"type":"boolean"},"available_now":{"type":"boolean","description":"今から60分以内に始められる枠がある"},"next_start":{"type":["string","null"],"description":"営業日の中で次に始められる時刻（HH:MM、JST）"},"minutes_until":{"type":["integer","null"],"minimum":0},"on_shift":{"type":["integer","null"],"minimum":0,"description":"今出勤しているキャストの人数（Level A のみ）"},"open_now":{"type":"boolean"},"biz_date":{"type":"string","format":"date","description":"営業日（深夜は前日の営業日）"},"as_of":{"type":"string","format":"date-time"}},"additionalProperties":false},"Availability":{"type":"object","required":["slug","name","booking_url","now"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"booking_url":{"type":["string","null"],"format":"uri"},"now":{"anyOf":[{"$ref":"#/components/schemas/Now"},{"type":"null"}]}},"additionalProperties":false},"Room":{"type":"object","required":["name","station_name","exit","walk_minutes","address"],"properties":{"name":{"type":"string"},"station_name":{"type":["string","null"]},"exit":{"type":["string","null"]},"walk_minutes":{"type":["number","null"]},"address":{"type":["string","null"]}},"additionalProperties":false},"Source":{"type":"object","required":["kind","url","fetched_at","confidence"],"properties":{"kind":{"type":["string","null"],"enum":["booking_ledger","official_site","directory","shop_provided","editorial",null]},"url":{"type":["string","null"],"format":"uri"},"fetched_at":{"type":["string","null"],"format":"date-time"},"confidence":{"type":["number","null"]}},"additionalProperties":false},"PrefAreas":{"type":"object","required":["pref","areas"],"properties":{"pref":{"type":"object","required":["slug","name","code"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"code":{"type":"string"}},"additionalProperties":false},"areas":{"type":"array","items":{"$ref":"#/components/schemas/Area"}}},"additionalProperties":false},"Area":{"type":"object","required":["slug","name","url","status","shop_count","open_now_count","stations"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"status":{"type":"string","enum":["published","preparing"]},"shop_count":{"type":"integer","minimum":0},"open_now_count":{"type":"integer","minimum":0},"stations":{"type":"array","items":{"$ref":"#/components/schemas/StationCount"}}},"additionalProperties":false},"StationCount":{"type":"object","required":["slug","name","url","shop_count"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"shop_count":{"type":"integer","minimum":0}},"additionalProperties":false},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found","invalid_param","rate_limited","unavailable"]},"message":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}}