{"openapi":"3.1.0","info":{"title":"保育園・幼稚園検索 API","version":"1.0.0","description":"全国67,000件以上の保育施設を検索するAPI。JSON・Markdownフォーマットに対応。","contact":{"email":"info@tc3.co.jp"}},"servers":[{"url":"https://hoiku.huu-family.com","description":"本番サーバー"}],"paths":{"/":{"get":{"summary":"施設検索","description":"都道府県・市区町村・キーワードで施設を検索します。`format=json` または `format=md` を付けるとAPI応答になります。","parameters":[{"name":"pref","in":"query","required":true,"schema":{"type":"string"},"description":"都道府県名（例: 東京都）"},{"name":"city","in":"query","schema":{"type":"string"},"description":"市区町村名（例: 中野区）"},{"name":"q","in":"query","schema":{"type":"string"},"description":"施設名・住所のキーワード"},{"name":"typeGroup","in":"query","schema":{"type":"string","enum":["保育所","幼稚園","小規模保育","家庭的保育"]},"description":"施設タイプ"},{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"ページ番号（1ページ30件）"},{"name":"format","in":"query","schema":{"type":"string","enum":["json","md"]},"description":"レスポンス形式（省略時はHTML）"}],"responses":{"200":{"description":"検索結果","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"総件数"},"page":{"type":"integer"},"facilities":{"type":"array","items":{"$ref":"#/components/schemas/FacilityCard"}}}}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/{pref}/{city}":{"get":{"summary":"エリア別施設一覧","parameters":[{"name":"pref","in":"path","required":true,"schema":{"type":"string"},"description":"都道府県名"},{"name":"city","in":"path","required":true,"schema":{"type":"string"},"description":"市区町村名"},{"name":"format","in":"query","schema":{"type":"string","enum":["json","md"]}}],"responses":{"200":{"description":"エリアの施設一覧","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/facilities/{facilityId}":{"get":{"summary":"施設詳細","parameters":[{"name":"facilityId","in":"path","required":true,"schema":{"type":"string"},"description":"施設ID"},{"name":"format","in":"query","schema":{"type":"string","enum":["json","md"]}}],"responses":{"200":{"description":"施設詳細情報","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Facility"}},"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"施設が見つかりません"}}}},"/api/cities":{"get":{"summary":"市区町村一覧","parameters":[{"name":"pref","in":"query","required":true,"schema":{"type":"string"},"description":"都道府県名"}],"responses":{"200":{"description":"市区町村名の配列","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}}}}}},"components":{"schemas":{"FacilityCard":{"type":"object","properties":{"facilityId":{"type":"string"},"name":{"type":"string"},"pref":{"type":"string"},"city":{"type":"string"},"address":{"type":"string","nullable":true},"facilityType":{"type":"string","nullable":true},"category":{"type":"string","enum":["licensed","unlicensed"]},"workingParentScore":{"type":"integer","minimum":0,"maximum":5,"nullable":true},"transparencyScore":{"type":"integer","minimum":0,"maximum":4,"nullable":true},"trustScore":{"type":"integer","minimum":0,"maximum":6,"nullable":true},"openWeekday":{"type":"string","nullable":true},"closeWeekday":{"type":"string","nullable":true},"saturdayOpen":{"type":"boolean","nullable":true},"tempCare":{"type":"boolean","nullable":true},"sickCare":{"type":"boolean","nullable":true},"minAcceptAge":{"type":"integer","nullable":true},"maxAcceptAge":{"type":"integer","nullable":true},"url":{"type":"string","format":"uri"}}},"Facility":{"type":"object","description":"FacilityCardの全フィールドに加え、詳細情報を含む"}}}}