OpenNavi Protocol v1.0

災害板が平時から準備している場所マスターを、自治体や地域運営者の現地サイトへ安全に引き継ぐための公開仕様です。

現地サイト運営者の手順

1. https://saigaiban.com/.well-known/opennavi.jsonを取得し、対応プロファイルを確認します。
2. 正規API https://saigaiban.com/api/opennavi/v1/handoff/{area-slug} に地域slugを入れてGETします。
3. pagination.nextCursor がある間は、?cursor=...で続きのページを取得します。
4. handoff.phaseとhandoff.nextを保存し、現地サイトが立ち上がったら現地サイトを正本にします。

引き継がれる情報

• 場所ID、名前、市区町村、カテゴリ
• 公開された位置、住所、出典、データ基準日
• 公開済みで非表示になっていない最新報告と報告件数

引き継がれない情報

• 電話番号、個人名、待ち合わせ、連絡先
• 非表示報告、管理者用ID、レビュー内部値
• 座標入りの地図URLや、OpenNavi・災害板の内部フィールド

正本の扱い

現在の災害板はpreparedフェーズです。handoff.nextはlocal-siteを示します。現地サイトが立ち上がった後は、自治体・事業者・社協などの一次情報と現地サイトの案内を正本として扱い、災害板の住民報告を公式情報へ昇格させません。

エンドポイント

• 正規: https://saigaiban.com/api/opennavi/v1/handoff/{area-slug}
• 互換: https://saigaiban.com/api/handoff/{area-slug}
• 上流の場所マスター: https://opennavi.org/api/board/places

プロファイル: handoff/v1 ／ レスポンススキーマ: saigaiban.handoff/v1 ／ GET・OPTIONS・CORS対応、書き込みなし。