{"openapi":"3.1.0","info":{"title":"Japan Data Center Watch Public Data API","version":"1.0.0","description":"日本国内のデータセンター施設、状態タイムライン、出典、地域の動き、関連ニュースを公開する読み取り専用API。\n\n最終確認日: 2026-07-19","license":{"name":"出典明記を条件とする利用許諾","url":"https://japandatacenter.org/methodology#data-use"}},"servers":[{"url":"https://japandatacenter.org"}],"paths":{"/api/v1/facilities":{"get":{"operationId":"facilities_list","summary":"公開施設一覧","description":"公開済み施設を都道府県コードと状態で絞り込み、名称・所在地・状態・確度・電力容量等を返します。\n\n並び順は都道府県、施設名の昇順です。","parameters":[{"name":"pref","in":"query","required":false,"description":"JIS都道府県コード2桁（例: 12=千葉県）","schema":{"type":"string","pattern":"^[0-9]{2}$"}},{"name":"status","in":"query","required":false,"description":"施設状態。許可値以外は400。","schema":{"type":"string","enum":["rumored","announced","pre_consultation","permitting","approved","under_construction","operational","expansion","paused","cancelled","closed","unknown"]}}],"responses":{"200":{"description":"成功","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"共有キャッシュ設定"},"Access-Control-Allow-Origin":{"schema":{"type":"string","const":"*"},"description":"成功レスポンスのCORS設定"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacilityListResponse"},"example":{"count":1,"items":[{"slug":"colt-inzai-1","canonical_name":"Colt印西データセンター1","prefecture":"千葉県","pref_code":"12","municipality":"印西市","status":"operational","status_as_of":null,"status_as_of_precision":"unknown","coordinate_precision":"municipality","evidence_level":"E3","power_capacity_mw":8,"power_capacity_type":"it_load","detail_url":"/facilities/colt-inzai-1"}]}}}},"400":{"description":"statusが許可値ではありません。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":"invalid status"}}}}},"security":[]}},"/api/v1/facilities/{slug}":{"get":{"operationId":"facility_detail","summary":"施設詳細","description":"施設本体、事業者、状態イベント、施設・イベントの出典、周辺電源コンテキストを返します。\n\nnotes_internal は返しません。 非公開または存在しないslugは404です。","parameters":[{"name":"slug","in":"path","required":true,"description":"施設一覧のslug","schema":{"type":"string","pattern":"^[a-z0-9-]+$"}}],"responses":{"200":{"description":"成功","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"共有キャッシュ設定"},"Access-Control-Allow-Origin":{"schema":{"type":"string","const":"*"},"description":"成功レスポンスのCORS設定"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacilityDetailResponse"},"example":{"facility":{"id":"78b7f12b8c38dd9e1fcb752b3486159a","slug":"colt-inzai-1","canonical_name":"Colt印西データセンター1","prefecture":"千葉県","municipality":"印西市","status":"operational","coordinate_precision":"municipality","evidence_level":"E3","power_capacity_mw":8,"power_capacity_type":"it_load","updated_at":"2026-07-15 17:44:34"},"operators":[],"events":[{"id":"178a32a9675f42b3a0c0df2e426673fe","facility_id":"78b7f12b8c38dd9e1fcb752b3486159a","event_date":null,"event_date_precision":"unknown","event_type":"operation","status_from":"unknown","status_to":"operational","title":"Colt印西データセンター1 稼働中","summary":"公式サイトに稼働開始日の明記なし。","created_at":"2026-07-15 17:43:45","sources":[]}],"sources":[{"id":"2e256605ca1f05bddbf66976b8616e0d","canonical_url":"https://www.coltdatacentres.net/ja-JP/our-locations/data-centre-locations-asia/inzai","original_url":"https://www.coltdatacentres.net/ja-JP/our-locations/data-centre-locations-asia/inzai","publisher":"Colt DCS","title":"Colt 印西データセンター1","published_date":null,"retrieved_at":"2026-07-15","source_type":"official","notes":null,"claim":"existence","support":"supports"}],"power_context":{"facility_id":"78b7f12b8c38dd9e1fcb752b3486159a","nearby_power_mw_30km":3929.8,"nearby_plant_count_30km":5,"nearest_large_plant_name":"千葉火力発電所","nearest_large_plant_type":"火力","nearest_large_plant_mw":1440,"nearest_large_plant_distance_km":30,"data_source_version":"P03-13（2013年度版）","computed_at":"2026-07-16 00:36:16"}}}}},"404":{"description":"公開施設が見つかりません。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":"not found"}}}}},"security":[]}},"/api/v1/facilities/geojson":{"get":{"operationId":"facilities_geojson","summary":"公開施設GeoJSON","description":"座標があり coordinate_precision が unknown ではない公開施設をGeoJSON FeatureCollectionで返します。\n\nContent-Typeはapplication/geo+json; charset=utf-8です。 互換別名 /api/v1/facilities.geojson も同じレスポンスを返します。 座標順は [longitude, latitude] です。coordinate_precision=municipality は施設の正確な位置ではありません。","parameters":[],"responses":{"200":{"description":"成功","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"共有キャッシュ設定"},"Access-Control-Allow-Origin":{"schema":{"type":"string","const":"*"},"description":"成功レスポンスのCORS設定"}},"content":{"application/geo+json":{"schema":{"$ref":"#/components/schemas/FacilityGeoJsonCollection"},"example":{"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Point","coordinates":[140.14583,35.83222]},"properties":{"slug":"colt-inzai-1","name":"Colt印西データセンター1","status":"operational","status_as_of":null,"status_as_of_precision":"unknown","coordinate_precision":"municipality","evidence_level":"E3","prefecture":"千葉県","municipality":"印西市","detail_url":"/facilities/colt-inzai-1"}}]}}}}},"security":[]}},"/api/v1/facilities.geojson":{"get":{"operationId":"facilities_geojson_alias","summary":"公開施設GeoJSON（互換別名）","description":"互換別名。正本は /api/v1/facilities/geojson です。","parameters":[],"responses":{"200":{"description":"成功","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"共有キャッシュ設定"},"Access-Control-Allow-Origin":{"schema":{"type":"string","const":"*"},"description":"成功レスポンスのCORS設定"}},"content":{"application/geo+json":{"schema":{"$ref":"#/components/schemas/FacilityGeoJsonCollection"},"example":{"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Point","coordinates":[140.14583,35.83222]},"properties":{"slug":"colt-inzai-1","name":"Colt印西データセンター1","status":"operational","status_as_of":null,"status_as_of_precision":"unknown","coordinate_precision":"municipality","evidence_level":"E3","prefecture":"千葉県","municipality":"印西市","detail_url":"/facilities/colt-inzai-1"}}]}}}}},"security":[],"deprecated":false}},"/api/v1/community-actions":{"get":{"operationId":"community_actions","summary":"地域の動き","description":"自治体の条例、議会・自治体対応、住民説明会等の公開記録を返します。\n\n最大100件。日付の新しい順です。","parameters":[{"name":"pref","in":"query","required":false,"description":"都道府県名の完全一致（例: 千葉県）。JISコードではありません。URLエンコードしてください。","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"共有キャッシュ設定"},"Access-Control-Allow-Origin":{"schema":{"type":"string","const":"*"},"description":"成功レスポンスのCORS設定"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityActionListResponse"},"example":{"count":1,"items":[{"id":"2ed4130b73a649429df244798bdc17d1","prefecture":"千葉県","municipality":"印西市","action_type":"district_plan_change","title":"印西市、相次ぐデータセンター紛争を受け地区計画の変更を検討","summary":"千葉ニュータウン中央駅近くの建築確認取消訴訟をはじめ、印西市内で住民とデータセンター事業者との紛争が相次いでいる。","action_date":"2026-07","action_date_precision":"month","evidence_level":"E1","facility_slug":null,"facility_name":null}]}}}}},"security":[]}},"/api/v1/news":{"get":{"operationId":"news","summary":"関連ニュース","description":"公開施設・イベント・地域の動きに実際に紐づいた検証済み出典を新しい順に返します。\n\n最大50件。未検証の収集候補は含みません。","parameters":[],"responses":{"200":{"description":"成功","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"共有キャッシュ設定"},"Access-Control-Allow-Origin":{"schema":{"type":"string","const":"*"},"description":"成功レスポンスのCORS設定"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsListResponse"},"example":{"count":1,"items":[{"id":"cd30983919300329e27804218d6866bd","canonical_url":"https://news.yahoo.co.jp/articles/e63981bc8769dd71ffe761ff37b5e5ceaaefd831","publisher":"TOKYO MX","title":"日野市のデータセンター計画、高さ・面積縮小へ 排熱の影響は「解析中」として示さず","published_date":"2026-07-13","retrieved_at":"2026-07-15","source_type":"media","context_label":"日野DC計画（三井不動産・日野自動車工場跡地）","context_url":"/facilities/mitsuifudosan-hino-dc","link_updated_at":"2026-07-15 17:32:23"}]}}}}},"security":[]}}},"components":{"schemas":{"FacilityListResponse":{"type":"object","title":"施設一覧レスポンス","description":"公開施設の件数と一覧。","properties":{"count":{"type":"integer","description":"itemsの件数"},"items":{"type":"array","items":{"$ref":"#/components/schemas/FacilitySummary"},"description":"公開施設一覧"}},"required":["count","items"],"additionalProperties":false},"FacilitySummary":{"type":"object","title":"施設一覧項目","description":"施設一覧で返す要約レコード。","properties":{"slug":{"type":"string","description":"URL・詳細APIで使う安定識別子"},"canonical_name":{"type":"string","description":"施設の標準名称"},"prefecture":{"type":"string","description":"都道府県名"},"pref_code":{"anyOf":[{"type":"string","description":"JIS都道府県コード2桁"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string","description":"市区町村"},{"type":"null"}]},"status":{"type":"string","enum":["rumored","announced","pre_consultation","permitting","approved","under_construction","operational","expansion","paused","cancelled","closed","unknown"],"description":"施設状態"},"status_as_of":{"anyOf":[{"type":"string","description":"状態の基準日（部分日付）"},{"type":"null"}]},"status_as_of_precision":{"type":"string","enum":["day","month","year","unknown"],"description":"status_as_ofの精度"},"coordinate_precision":{"type":"string","enum":["exact","block","district","municipality","unknown"],"description":"公開座標の精度"},"evidence_level":{"type":"string","enum":["E1","E2","E3","E4","E5"],"description":"公開情報の確度"},"power_capacity_mw":{"anyOf":[{"type":"number","description":"公表された電力容量（単位: MW）"},{"type":"null"}]},"power_capacity_type":{"anyOf":[{"type":"string","enum":["it_load","utility_supply","facility_total","campus_total","planned_maximum","unknown"],"description":"電力容量の意味区分"},{"type":"null"}]},"detail_url":{"type":"string","description":"本サイト内の施設詳細相対URL"}},"required":["slug","canonical_name","prefecture","status","status_as_of_precision","coordinate_precision","evidence_level","detail_url"],"additionalProperties":false},"FacilityDetailResponse":{"type":"object","title":"施設詳細レスポンス","description":"施設本体と関連情報。","properties":{"facility":{"$ref":"#/components/schemas/Facility","description":"施設本体"},"operators":{"type":"array","items":{"$ref":"#/components/schemas/Operator"},"description":"関連事業者"},"events":{"type":"array","items":{"$ref":"#/components/schemas/FacilityEvent"},"description":"出典付き状態タイムライン"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/FacilityEvidenceSource"},"description":"施設レベルの出典"},"power_context":{"anyOf":[{"$ref":"#/components/schemas/PowerContext","description":"周辺電源の集計値"},{"type":"null"}]}},"required":["facility","operators","events","sources","power_context"],"additionalProperties":false},"Facility":{"type":"object","title":"施設本体","description":"notes_internalを除いた公開施設レコード。","properties":{"id":{"type":"string","description":"内部一意ID"},"slug":{"type":"string","description":"公開識別子"},"canonical_name":{"type":"string","description":"標準名称"},"canonical_name_en":{"anyOf":[{"type":"string","description":"英語名称"},{"type":"null"}]},"prefecture":{"type":"string","description":"都道府県名"},"pref_code":{"anyOf":[{"type":"string","description":"JIS都道府県コード2桁"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string","description":"市区町村"},{"type":"null"}]},"address_public":{"anyOf":[{"type":"string","description":"公開可能な住所"},{"type":"null"}]},"latitude_public":{"anyOf":[{"type":"number","description":"公開緯度（単位: decimal degrees）"},{"type":"null"}]},"longitude_public":{"anyOf":[{"type":"number","description":"公開経度（単位: decimal degrees）"},{"type":"null"}]},"coordinate_precision":{"type":"string","enum":["exact","block","district","municipality","unknown"],"description":"座標精度"},"status":{"type":"string","enum":["rumored","announced","pre_consultation","permitting","approved","under_construction","operational","expansion","paused","cancelled","closed","unknown"],"description":"施設状態"},"status_as_of":{"anyOf":[{"type":"string","description":"状態の基準日（部分日付）"},{"type":"null"}]},"status_as_of_precision":{"type":"string","enum":["day","month","year","unknown"],"description":"状態基準日の精度"},"announced_date":{"anyOf":[{"type":"string","description":"計画公表日（部分日付）"},{"type":"null"}]},"construction_start_date":{"anyOf":[{"type":"string","description":"着工日（部分日付）"},{"type":"null"}]},"operational_date":{"anyOf":[{"type":"string","description":"稼働日（部分日付）"},{"type":"null"}]},"site_area_m2":{"anyOf":[{"type":"number","description":"敷地面積（単位: m²）"},{"type":"null"}]},"floor_area_m2":{"anyOf":[{"type":"number","description":"延床・床面積（単位: m²）"},{"type":"null"}]},"power_capacity_mw":{"anyOf":[{"type":"number","description":"電力容量（単位: MW）"},{"type":"null"}]},"power_capacity_type":{"anyOf":[{"type":"string","enum":["it_load","utility_supply","facility_total","campus_total","planned_maximum","unknown"],"description":"電力容量の意味区分"},{"type":"null"}]},"power_capacity_note":{"anyOf":[{"type":"string","description":"容量の補足"},{"type":"null"}]},"cooling_type":{"anyOf":[{"type":"string","description":"冷却方式"},{"type":"null"}]},"water_source":{"anyOf":[{"type":"string","description":"水源・水利用"},{"type":"null"}]},"ai_workload_claim":{"anyOf":[{"type":"string","description":"AI用途に関する公表内容"},{"type":"null"}]},"pue":{"anyOf":[{"type":"number","description":"Power Usage Effectiveness"},{"type":"null"}]},"pue_type":{"anyOf":[{"type":"string","enum":["actual","target"],"description":"PUEが実績値か目標値か"},{"type":"null"}]},"pue_as_of":{"anyOf":[{"type":"string","description":"PUEの基準日（部分日付）"},{"type":"null"}]},"pue_as_of_precision":{"type":"string","enum":["day","month","year","unknown"],"description":"PUE基準日の精度"},"power_colocation":{"anyOf":[{"type":"string","enum":["onsite_generation","dedicated_ppa","colocated_site","renewable_dedicated","planned"],"description":"発電所併設・専用電源の区分"},{"type":"null"}]},"power_colocation_note":{"anyOf":[{"type":"string","description":"電源併設の補足"},{"type":"null"}]},"evidence_level":{"type":"string","enum":["E1","E2","E3","E4","E5"],"description":"確度"},"last_verified_at":{"anyOf":[{"type":"string","description":"最終検証日時"},{"type":"null"}]},"review_status":{"type":"string","const":"published","description":"公開状態（公開APIではpublished）"},"published_at":{"anyOf":[{"type":"string","description":"公開日時"},{"type":"null"}]},"created_at":{"type":"string","description":"作成日時"},"updated_at":{"type":"string","description":"更新日時"},"deleted_at":{"anyOf":[{"type":"string","description":"削除日時（公開APIではnull）"},{"type":"null"}]}},"required":["id","slug","canonical_name","prefecture","coordinate_precision","status","status_as_of_precision","pue_as_of_precision","evidence_level","review_status","created_at","updated_at"],"additionalProperties":false},"Operator":{"type":"object","title":"関連事業者","description":"施設と関係する事業者。","properties":{"id":{"type":"string","description":"事業者ID"},"slug":{"type":"string","description":"事業者識別子"},"name":{"type":"string","description":"名称"},"name_en":{"anyOf":[{"type":"string","description":"英語名称"},{"type":"null"}]},"website_url":{"anyOf":[{"type":"string","format":"uri","description":"公式サイト"},{"type":"null"}]},"role":{"type":"string","enum":["operator","owner","developer"],"description":"施設との関係"}},"required":["id","slug","name","role"],"additionalProperties":false},"FacilityEvent":{"type":"object","title":"施設イベント","description":"追記型の状態タイムライン。","properties":{"id":{"type":"string","description":"イベントID"},"facility_id":{"type":"string","description":"施設ID"},"event_date":{"anyOf":[{"type":"string","description":"イベント日（部分日付）"},{"type":"null"}]},"event_date_precision":{"type":"string","enum":["day","month","year","unknown"],"description":"イベント日の精度"},"event_type":{"type":"string","enum":["status_change","announcement","permit","construction","operation","expansion","pause","cancellation","correction","other"],"description":"イベント種別"},"status_from":{"anyOf":[{"type":"string","enum":["rumored","announced","pre_consultation","permitting","approved","under_construction","operational","expansion","paused","cancelled","closed","unknown"],"description":"変更前状態"},{"type":"null"}]},"status_to":{"anyOf":[{"type":"string","enum":["rumored","announced","pre_consultation","permitting","approved","under_construction","operational","expansion","paused","cancelled","closed","unknown"],"description":"変更後状態"},{"type":"null"}]},"title":{"type":"string","description":"見出し"},"summary":{"anyOf":[{"type":"string","description":"要約"},{"type":"null"}]},"created_at":{"type":"string","description":"記録作成日時"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/EvidenceSource"},"description":"イベントの出典"}},"required":["id","facility_id","event_date_precision","event_type","title","created_at","sources"],"additionalProperties":false},"EvidenceSource":{"type":"object","title":"出典","description":"正規化した公開出典。","properties":{"id":{"type":"string","description":"出典ID"},"canonical_url":{"type":"string","format":"uri","description":"正規化URL"},"original_url":{"type":"string","format":"uri","description":"収集時URL"},"publisher":{"type":"string","description":"発行元"},"title":{"type":"string","description":"資料・記事名"},"published_date":{"anyOf":[{"type":"string","description":"公表日（部分日付の場合あり）"},{"type":"null"}]},"retrieved_at":{"type":"string","description":"取得日"},"source_type":{"type":"string","enum":["official","media","gov_doc","filing","other"],"description":"出典種別"},"notes":{"anyOf":[{"type":"string","description":"公開補足"},{"type":"null"}]}},"required":["id","canonical_url","original_url","publisher","title","retrieved_at","source_type"],"additionalProperties":false},"FacilityEvidenceSource":{"type":"object","title":"施設出典","description":"出典に主張種別と支持関係を加えたもの。","properties":{"id":{"type":"string","description":"出典ID"},"canonical_url":{"type":"string","format":"uri","description":"正規化URL"},"original_url":{"type":"string","format":"uri","description":"収集時URL"},"publisher":{"type":"string","description":"発行元"},"title":{"type":"string","description":"資料・記事名"},"published_date":{"anyOf":[{"type":"string","description":"公表日"},{"type":"null"}]},"retrieved_at":{"type":"string","description":"取得日"},"source_type":{"type":"string","enum":["official","media","gov_doc","filing","other"],"description":"出典種別"},"notes":{"anyOf":[{"type":"string","description":"公開補足"},{"type":"null"}]},"claim":{"type":"string","enum":["existence","location","operator","status","power_capacity","site_area","cooling","water","ai_workload","schedule","efficiency","power_procurement","other"],"description":"裏づける主張"},"support":{"type":"string","enum":["supports","disputes","context"],"description":"主張との関係"}},"required":["id","canonical_url","original_url","publisher","title","retrieved_at","source_type","claim","support"],"additionalProperties":false},"PowerContext":{"type":"object","title":"周辺電源コンテキスト","description":"国土数値情報から計算した集計値。個別発電所生データではありません。","properties":{"facility_id":{"type":"string","description":"施設ID"},"nearby_power_mw_30km":{"anyOf":[{"type":"number","description":"半径30km内の発電容量合計（単位: MW）"},{"type":"null"}]},"nearby_plant_count_30km":{"anyOf":[{"type":"integer","description":"半径30km内の発電施設数（単位: 件）"},{"type":"null"}]},"nearest_large_plant_name":{"anyOf":[{"type":"string","description":"最寄り500MW以上発電所名"},{"type":"null"}]},"nearest_large_plant_type":{"anyOf":[{"type":"string","description":"発電種別"},{"type":"null"}]},"nearest_large_plant_mw":{"anyOf":[{"type":"number","description":"最寄り大規模発電所容量（単位: MW）"},{"type":"null"}]},"nearest_large_plant_distance_km":{"anyOf":[{"type":"number","description":"最寄り大規模発電所までの距離（単位: km）"},{"type":"null"}]},"data_source_version":{"type":"string","description":"計算元データの版"},"computed_at":{"type":"string","description":"計算日時"}},"required":["facility_id","data_source_version","computed_at"],"additionalProperties":false},"FacilityGeoJsonCollection":{"type":"object","title":"施設GeoJSON","description":"GeoJSON FeatureCollection。","properties":{"type":{"type":"string","const":"FeatureCollection","description":"GeoJSON種別"},"features":{"type":"array","items":{"$ref":"#/components/schemas/FacilityGeoJsonFeature"},"description":"施設Feature"}},"required":["type","features"],"additionalProperties":false},"FacilityGeoJsonFeature":{"type":"object","title":"施設GeoJSON Feature","description":"施設1件のPoint Feature。","properties":{"type":{"type":"string","const":"Feature","description":"GeoJSON種別"},"geometry":{"$ref":"#/components/schemas/PointGeometry","description":"位置"},"properties":{"$ref":"#/components/schemas/FacilityGeoJsonProperties","description":"施設属性"}},"required":["type","geometry","properties"],"additionalProperties":false},"PointGeometry":{"type":"object","title":"Point geometry","description":"GeoJSON Point。","properties":{"type":{"type":"string","const":"Point","description":"geometry種別"},"coordinates":{"type":"array","items":{"type":"number"},"description":"WGS84座標（単位: [経度, 緯度]）"}},"required":["type","coordinates"],"additionalProperties":false},"FacilityGeoJsonProperties":{"type":"object","title":"GeoJSON施設属性","description":"地図描画用の施設要約。","properties":{"slug":{"type":"string","description":"施設識別子"},"name":{"type":"string","description":"施設名称"},"status":{"type":"string","enum":["rumored","announced","pre_consultation","permitting","approved","under_construction","operational","expansion","paused","cancelled","closed","unknown"],"description":"施設状態"},"status_as_of":{"anyOf":[{"type":"string","description":"状態の基準日"},{"type":"null"}]},"status_as_of_precision":{"type":"string","enum":["day","month","year","unknown"],"description":"状態基準日の精度"},"coordinate_precision":{"type":"string","enum":["exact","block","district","municipality","unknown"],"description":"座標精度"},"evidence_level":{"type":"string","enum":["E1","E2","E3","E4","E5"],"description":"確度"},"prefecture":{"type":"string","description":"都道府県"},"municipality":{"anyOf":[{"type":"string","description":"市区町村"},{"type":"null"}]},"detail_url":{"type":"string","description":"施設詳細相対URL"}},"required":["slug","name","status","status_as_of_precision","coordinate_precision","evidence_level","prefecture","detail_url"],"additionalProperties":false},"CommunityActionListResponse":{"type":"object","title":"地域の動きレスポンス","description":"地域記録の件数と一覧。","properties":{"count":{"type":"integer","description":"itemsの件数"},"items":{"type":"array","items":{"$ref":"#/components/schemas/CommunityAction"},"description":"地域記録"}},"required":["count","items"],"additionalProperties":false},"CommunityAction":{"type":"object","title":"地域の動き項目","description":"自治体・住民等の公開記録。","properties":{"id":{"type":"string","description":"記録ID"},"prefecture":{"type":"string","description":"都道府県"},"municipality":{"anyOf":[{"type":"string","description":"市区町村"},{"type":"null"}]},"action_type":{"type":"string","enum":["ordinance","lawsuit","council_response","public_hearing","protest","district_plan_change","other"],"description":"記録種別"},"title":{"type":"string","description":"見出し"},"summary":{"anyOf":[{"type":"string","description":"要約"},{"type":"null"}]},"action_date":{"anyOf":[{"type":"string","description":"日付（部分日付）"},{"type":"null"}]},"action_date_precision":{"type":"string","enum":["day","month","year","unknown"],"description":"日付精度"},"evidence_level":{"type":"string","enum":["E1","E2","E3","E4","E5"],"description":"確度"},"facility_slug":{"anyOf":[{"type":"string","description":"関連施設slug"},{"type":"null"}]},"facility_name":{"anyOf":[{"type":"string","description":"関連施設名"},{"type":"null"}]}},"required":["id","prefecture","action_type","title","action_date_precision","evidence_level"],"additionalProperties":false},"NewsListResponse":{"type":"object","title":"関連ニュースレスポンス","description":"検証済み出典の件数と一覧。","properties":{"count":{"type":"integer","description":"itemsの件数"},"items":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"},"description":"ニュース項目"}},"required":["count","items"],"additionalProperties":false},"NewsItem":{"type":"object","title":"関連ニュース項目","description":"公開データに紐づいた出典。","properties":{"id":{"type":"string","description":"出典ID"},"canonical_url":{"type":"string","format":"uri","description":"記事URL"},"publisher":{"type":"string","description":"発行元"},"title":{"type":"string","description":"記事名"},"published_date":{"anyOf":[{"type":"string","description":"公開日"},{"type":"null"}]},"retrieved_at":{"type":"string","description":"取得日"},"source_type":{"type":"string","description":"出典種別"},"context_label":{"type":"string","description":"関連施設・地域記録の表示名"},"context_url":{"anyOf":[{"type":"string","description":"関連する本サイト内相対URL"},{"type":"null"}]},"link_updated_at":{"type":"string","description":"出典リンクの最終更新日時"}},"required":["id","canonical_url","publisher","title","retrieved_at","source_type","context_label","link_updated_at"],"additionalProperties":false},"ErrorResponse":{"type":"object","title":"エラーレスポンス","description":"現在のv1で明示的に返すエラー。","properties":{"error":{"type":"string","description":"機械可読な短いエラー文字列"}},"required":["error"],"additionalProperties":false}}},"x-update-frequency":"施設・地域記録は出典確認後に随時更新。関連ニュースは公開データに紐づいた出典から生成され、最大50件を返します。各レコードの updated_at、last_verified_at、published_date、retrieved_at 等で個別の鮮度を確認してください。","x-compatibility-policy":"URLの /api/v1 をメジャーバージョンとします。v1内では項目追加など後方互換の変更を行う場合があります。既存項目の削除・型変更など破壊的変更は /api/v2 など新しいメジャーパスで提供します。","x-cors-note":"CORSはブラウザからの取得可否を決める配信設定であり、agent-readyの判定要件ではありません。現行の400/404エラーレスポンスではCORSヘッダーを保証しません。"}