{"openapi":"3.1.0","info":{"title":"スターリンク防災ナビ API","version":"1.0.0","description":"郵便番号から地域の災害時の孤立リスクを簡易判定する API。住所は zipcloud、座標と標高は国土地理院の API から取得する。入力値は保存しない。","contact":{"name":"CreationStock合同会社","url":"https://www.nomore-offline.com/about"}},"servers":[{"url":"https://www.nomore-offline.com"}],"externalDocs":{"description":"開発者・AI エージェント向け情報","url":"https://www.nomore-offline.com/developers"},"paths":{"/api/zip-risk":{"get":{"operationId":"getZipRisk","summary":"郵便番号から孤立リスクを簡易判定する","description":"離島・半島・村や町・標高・周辺地域の大災害の記録から点数化し、低・中・高で返す。道路や家族構成は含まないため、目安として使う。","parameters":[{"name":"zip","in":"query","required":true,"description":"郵便番号 7 桁。ハイフンや全角数字も受け付ける","schema":{"type":"string","examples":["9270433","927-0433"]}}],"responses":{"200":{"description":"判定結果","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZipRisk"}}}},"400":{"description":"郵便番号の形式が不正","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"該当する住所がない","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"住所検索サービスに接続できない","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"稼働確認","responses":{"200":{"description":"稼働中","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","examples":["ok"]}},"required":["status"]}}}}}}}},"components":{"schemas":{"ZipRisk":{"type":"object","required":["zipcode","address","score","maxScore","level","signals"],"properties":{"zipcode":{"type":"string"},"address":{"type":"string"},"lat":{"type":["number","null"]},"lon":{"type":["number","null"]},"prefecture":{"type":"string"},"municipality":{"type":"string"},"elevation":{"type":["number","null"],"description":"町域の代表地点の標高（m）"},"score":{"type":"integer"},"maxScore":{"type":"integer"},"level":{"type":"string","enum":["低","中","高"]},"headline":{"type":"string"},"advice":{"type":"string"},"signals":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"detail":{"type":"string"},"points":{"type":"integer"}}}},"disasters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"date":{"type":"string","format":"date"},"region":{"type":"string"}}}},"disasterCount":{"type":"integer"}}},"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}