Wolfx WebSocket API 利用説明

#WebSocket の概要

• WebSocket API は、サーバーが EEW を受信すると、すべてのクライアントに自動的に関連情報をプッシュ配信します。
• ハートビートメカニズム：サーバーは毎分、または接続確立後にハートビートパケットを送信して接続を維持します。クライアントは任意で ping パケットを返信することができます（推奨）。

#接続および利用上の注意

• 原則として、同一のクライアントがWolfx ProjectのEEW WebSocketサービスに同時に維持する有効な接続は1本としてください。複数のUIコンポーネントごとに接続を作るなどの不要な重複接続を避け、可能な限り既存の接続を再利用してください。
• 切断後の再接続を適切に管理し、不必要な接続の反復やリソースの浪費を避けてください。通常の接続切替時に新旧の接続が短時間重なることだけをもって、悪意ある重複接続とはみなしません。これはクライアントの合理的利用に関する要件であり、サーバーが接続数を厳密に1本へ制限する機構を実装しているという説明ではありません。
• 複数のEEWデータ源を同時に取得する必要がある場合は、実際の要件と下記の接続先の説明に応じて、既存のall_eew集約チャンネルの利用を優先的に検討してください。この案内は、未確認のデータへの対応を保証するものではありません。
• 利用規約第六条に従う通常の情報利用は、自己のサーバーを介した処理・伝達を含め、個別許諾を要しません。同条に定める独立したデータ再提供には事前の明示的許諾が必要です。その他の利用条件およびデータ源の適用条件も遵守してください。

#WebSocket 呼び出し URL

• すべての JSON API プッシュを受信:

wss://ws-api.wolfx.jp/all_eew

• 四川省地震局 地震速報 JSON API:

wss://ws-api.wolfx.jp/sc_eew

• JMA 緊急地震速報 JSON API:

wss://ws-api.wolfx.jp/jma_eew

• 福建省地震局 地震速報 JSON API:

wss://ws-api.wolfx.jp/fj_eew

• 重庆市地震局 地震速報 JSON API:

wss://ws-api.wolfx.jp/cq_eew

• 中国地震台網 地震速報 JSON API:

wss://ws-api.wolfx.jp/cenc_eew

• 中国地震台網 地震情報 JSON API:

wss://ws-api.wolfx.jp/cenc_eqlist

• JMA 地震情報 JSON API:

wss://ws-api.wolfx.jp/jma_eqlist

• JSON フィールドの解析詳細は：https://api.wolfx.jp を参照ください。

#WebSocket 手動クエリコマンド

• Ping:

ping

• 四川省地震局 地震速報 JSON:

query_sceew

• JMA 緊急地震速報 JSON:

query_jmaeew

• 福建省地震局 地震速報 JSON:

query_fjeew

• 重庆市地震局 地震速報 JSON:

query_cqeew

• 中国地震台網 地震速報 JSON:

query_cenceew

• 中国地震台網 地震情報 JSON:

query_cenceqlist

• JMA 地震情報 JSON:

query_jmaeqlist

#WebSocket JSON データ仕様

• 共通のJSONフィールドの説明:

• WebSocket ハートビート（heartbeat）パケットのJSONフィールド説明:

• WebSocket Pong パケットのJSONフィールド説明: