WHEWS API

所有 /ws/* 端点均需携带令牌。令牌固定不变（除非在 WAuth 后台吊销或设置了有效期），每次连接仅鉴权一次。提供令牌有两种方式：

// 方式一（推荐）：连接 URL 携带 token 查询参数
wss://api.2v8.cn/ws/va?token=wat_xxxxxxxx

// 方式二：连接后的第一帧发送令牌（纯文本或 JSON）
wat_xxxxxxxx
{ "token": "wat_xxxxxxxx" }

服务端完成 WebSocket 握手后向 WAuth 发起校验：校验通过则接受连接并将 user_id 绑定到会话；校验失败（令牌无效/缺失/首帧超时）则以关闭码 4401 关闭连接。若未在 URL 携带 token，需在连接后 5 秒内发送首帧令牌，否则超时关闭。

# WAuth 校验请求（服务端内部发起）：
curl -X POST https://auth.beecld.com/api/token/verify   -H "Content-Type: application/json"   -d '{"token":"wat_xxxxxxxx"}'

# 校验通过：
{ "valid": true, "user_id": 12, "username": "alice", "role": "user" }
# 校验失败：
{ "valid": false, "error": "令牌无效" }

连接建立后，服务器向【所有】WebSocket 端点的客户端每 30 秒下发一帧心跳，用于保持链路活跃、探测断线。心跳帧与业务数据帧（含 Data）结构不同，客户端可根据 type 字段区分并忽略。

{
  "type": "heartbeat",
  "ver": "1.0.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",  // 本次心跳的 UUID
  "timestamp": 1630000000000                      // 毫秒时间戳（见下方说明）
}

字段说明

客户端可主动发送 ping 探测服务器存活，服务器立即回复 pong。支持两种方式：（一）发送 JSON 文本帧 {"type":"ping"}（也兼容纯文本 ping）→ 服务器回 {"type":"pong",...}；（二）发送 WebSocket 协议级 Ping 控制帧 → 服务器回协议级 Pong 控制帧。

// 客户端发送（文本帧）：
{ "type": "ping" }

// 服务器回复：
{
  "type": "pong",
  "timestamp": 1630000000000   // 与心跳同源的 Lmoni 时间戳
}

字段说明

緊急地震速報（EEW），时间为 UTC+9。

{
  "Data": {
    "id": "20260119...",       // 事件 ID
    "updates": 4,                // 报数
    "shockTime": "2026-01-19 07:48:27",   // 发震时刻 UTC+9
    "createTime": "2026-01-19 07:48:35",  // 发报时刻 UTC+9
    "latitude": 35.5, "longitude": 140.2,
    "depth": 10.0, "magnitude": 5.3,
    "placeName": "千葉県北西部",     // 日语原文
    "epiIntensity": "5弱",         // 预想最大震度
    "infoTypeName": "警報",       // 予報 / 警報
    "final": false, "cancel": false
  },
  "md5": "..."                    // Data 内容的 md5，可用于去重
}

字段说明

美国西海岸 ShakeAlert 地震预警（加州 / 俄勒冈 / 华盛顿），时间为 UTC+8；不过滤时间与震级，全量转发。

{
  "Data": {
    "id": "ci40826536",          // 事件 ID
    "shockTime": "2026-07-18 09:12:33",   // 发震时刻 UTC+8
    "createTime": "2026-07-18 09:12:41",  // 发报时刻 UTC+8
    "latitude": 37.87, "longitude": -122.27,
    "depth": 8.0, "magnitude": 4.6,
    "placeName": "美国加利福尼亚州伯克利",   // 经地名库按坐标转中文
    "epiIntensity": "4.2"         // CEA 估算烈度
  },
  "md5": "...",                   // Data 内容的 md5，可用于去重
  "source": "sa_eew"
}

字段说明

中国地震预警网（国家级），收到新预警后立即推送；时间为 UTC+8。

{
  "Data": {
    "id": "bi9wyea65mayd",       // 预警事件唯一标识符
    "shockTime": "2025-07-15 22:47:25",   // 发震时间 UTC+8
    "longitude": 101.09, "latitude": 29.43,
    "placeName": "四川甘孜州雅江县",
    "magnitude": 4.0,
    "epiIntensity": 5.5,          // 预估地震烈度(可为 null)
    "depth": 8,                   // 震源深度 km(可为 null)
    "updates": 3                  // 该事件的更新报数
  },
  "md5": "...",                   // Data 内容的 md5，可用于去重
  "source": "cea"
}

字段说明

中国地震预警网各省级分中心，收到新预警或更新后立即推送；字段与 /ws/cea 一致，多一个 province（发布省份）。时间为 UTC+8。

{
  "Data": {
    "id": "bs1cppwt59wyy",
    "shockTime": "2025-09-12 05:50:58",
    "longitude": 102.89, "latitude": 33.002,
    "placeName": "四川阿坝州红原县",
    "magnitude": 4.4,
    "epiIntensity": 6.1,
    "depth": 5,
    "updates": 1,
    "province": "四川"            // 发布的省级分中心所属省份
  },
  "md5": "...",
  "source": "cea-pr"
}

字段说明

震源・震度に関する情報（VXSE53），时间为 UTC+9。placeName 及各级区域/测站名为日语原文。

{
  "Data": {
    "id": "20260723182235",     // 事件 ID (EventID)
    "updates": 1,                // 报数 (Serial)
    "shockTime": "2026-07-23 18:22:00",  // 发震时刻 UTC+9
    "createTime": "2026-07-23 18:26:00",  // 发报时刻 UTC+9
    "latitude": 27.8, "longitude": 130.2,
    "depth": 10.0, "magnitude": 4.7,
    "placeName": "奄美大島近海",   // 日语原文
    "maxIntensity": "3",         // 全域最大震度
    "infoTypeName": "発表",       // 発表 / 訂正 / 取消
    "title": "震源・震度に関する情報",
    "intensities": [              // 震度分布(都道府県 → 细分区域 → 市町村 → 观测点)
      {
        "pref": "鹿児島県", "maxIntensity": "3",
        "areas": [
          {
            "area": "鹿児島県奄美北部", "maxIntensity": "3",
            "cities": [
              {
                "name": "喜界町", "maxIntensity": "3",
                "stations": [
                  { "name": "喜界町湾＊", "intensity": "3" }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "md5": "...",
  "source": "jma"
}

字段说明

地震预警（EEW），时间为 UTC+8，placeName 为繁体中文。

{
  "Data": {
    "id": "114...",              // 事件 ID
    "updates": 2,                // 报数
    "shockTime": "2026-01-19 07:48:27",   // 发震时刻 UTC+8
    "latitude": 23.33, "longitude": 120.82,
    "depth": 10.0, "magnitude": 4.5,
    "placeName": "高雄市桃源區"      // 繁体中文
  },
  "md5": "..."
}

字段说明

正式地震报告，时间为 UTC+8。placeName 为官方 loc 中文原文（含相对方位描述）。

{
  "Data": {
    "id": "114...",              // 报告 ID
    "magnitude": 4.5,
    "placeName": "雲林縣政府南南东方 11.1 公里 (位於雲林縣古坑鄉)",  // loc 原文
    "shockTime": "2026-01-19 07:48:27",   // 发震时刻 UTC+8
    "updateTime": "2026-01-19 07:48:27",
    "longitude": 120.42, "latitude": 23.58,
    "depth": 12.5,
    "source": "cwa"
  },
  "md5": "..."
}

字段说明

正式地震情报，时间为 UTC+8。placeName 为官方中文地名（国内外均中文）。

{
  "Data": {
    "id": "CD.20260722115253.943",   // eqid
    "infoTypeName": "正式测定",        // eq_type: M=正式测定 / A=自动测定
    "magnitude": 3.1,
    "placeName": "云南普洱市墨江县",   // loc_name 原文
    "shockTime": "2026-07-22 11:45:36",    // 发震时刻 UTC+8
    "updateTime": "2026-07-22 11:53:06",
    "longitude": 101.45, "latitude": 23.2,
    "depth": 10.0,
    "createTime": "2026-07-22 11:53:06",   // = 原始 updateTime
    "source": "cenc"
  },
  "md5": "..."
}

字段说明

韩国气象厅（KMA）国内地震情报（震级≥2.0），来源为官方检索页 earthquake-korea.do。原始时间为 KST（UTC+9），已统一转为 UTC+8。页面无地名列，placeName 由经纬度按地名库反查为中文。

{
  "Data": {
    "id": "kma_20260723034704",       // 发震时刻紧凑串(KST)
    "magnitude": 2.6,
    "placeName": "韩国庆尚北道",           // 按坐标反查
    "shockTime": "2026-07-23 02:47:04",   // 发震时刻 UTC+8
    "updateTime": "2026-07-23 02:47:04",
    "longitude": 128.44, "latitude": 36.66,
    "depth": 13.0,
    "maxIntensity": "Ⅳ",                    // 最大震度(罗马数字)；无时省略
    "source": "kma"
  },
  "md5": "..."
}

字段说明

陆域实时震度。首连推送测站列表，之后每帧 shindo 数组与测站按下标一一对应。

// 首连推送：测站列表（下标与后续 shindo 数组一一对应）
{
  "type": "nied_stations_update",
  "timestamp": "2026-01-19 07:48:27",
  "stations": [
    { "latitude": 35.68, "longitude": 139.76 }
    // ...
  ]
}

// 之后每帧：实时震度
{
  "Data": {
    "timestamp": "2026-01-19 07:48:27",
    "shindo": [0.5, 1.2, -3.0]   // 按测站下标对应；-3.0 表无效
  },
  "md5": "..."                     // Data 内容的 md5，可用于去重
}

字段说明

海底实时震度。首连推送测站列表，之后每帧 shindo 数组与测站按下标一一对应（帧结构与 NIED 一致）。

// 首连推送：测站列表（下标与后续 shindo 数组一一对应）
{
  "type": "snet_stations_update",
  "timestamp": "2026-01-19 07:48:27",
  "stations": [
    { "latitude": 38.12, "longitude": 142.55 }
    // ...
  ]
}

// 之后每帧：实时震度
{
  "Data": {
    "timestamp": "2026-01-19 07:48:27",
    "shindo": [0.3, -3.0, 2.1]   // 按测站下标对应；-3.0 表无效
  },
  "md5": "..."                     // Data 内容的 md5，可用于去重
}

字段说明

韩国气象厅 PEWS 实时震度（MMI）。测站坐标与震度均来自位压缩二进制（非颜色提取），原始 4bit 级别经映射为客户端震度刻度（-3..11）。首连推送测站列表，之后每帧 mmi 数组与测站按下标一一对应。时钟仅由 KMA 响应头 ST（服务器 epoch 秒）对时，文件名按 UTC，展示时间为 KST。

// 首连推送：测站列表（下标与后续 mmi 数组一一对应）
{
  "type": "kma_stations_update",
  "timestamp": "2026-01-19 07:48:27",
  "stations": [
    { "latitude": 37.57, "longitude": 126.98 }
    // ...
  ]
}

// 之后每帧：实时震度
{
  "Data": {
    "timestamp": "2026-01-19 07:48:27",   // 数据时刻（KST，由 UTC 帧时间 +9h）
    "mmi": [-3, -2, 0, 2]                  // 各测站震度，按测站下标对应
  },
  "md5": "...",                            // Data 去重用（对键排序后的 Data 取 md5）
  "source": "kma_station"
}

字段说明

印尼地震情报，时间已转 UTC+8。

{
  "Data": {
    "id": "2026-07-22T04:18:23+00:00",   // BMKG 无 id，用原 DateTime
    "infoTypeName": "",
    "magnitude": 5.6,
    "placeName": "41 km TimurLaut KAB-GAYOLUES-ACEH",
    "shockTime": "2026-07-22 12:18:23",   // UTC+8
    "updateTime": "2026-07-22 12:18:23",  // UTC+8
    "longitude": 97.62, "latitude": 4.25,
    "depth": 10.0, "source": "BMKG"
  },
  "md5": "..."
}

字段说明

新西兰地震情报，时间已转 UTC+8；infoTypeName 为测定质量（best / preliminary / automatic）。

{
  "Data": {
    "id": "2026p548905",
    "infoTypeName": "best",
    "magnitude": 3.6,
    "placeName": "新西兰南岛",   // 经地名库按坐标转中文
    "shockTime": "2026-07-23 10:16:39",   // UTC+8
    "updateTime": "2026-07-23 10:16:39",
    "longitude": 170.14, "latitude": -44.1,
    "depth": 5.0, "source": "GeoNet"
  },
  "md5": "..."
}

字段说明

泰国地震情报，时间已转 UTC+8。

{
  "Data": {
    "id": "16871",
    "infoTypeName": "",
    "magnitude": 2.6,
    "placeName": "ประเทศเมียนมา",
    "shockTime": "2026-07-23 04:57:43",   // UTC+8
    "updateTime": "2026-07-23 04:57:43",
    "longitude": 98.058, "latitude": 19.944,
    "depth": 5.0, "source": "TMD"
  },
  "md5": "..."
}

字段说明

巴西地震情报，时间已转 UTC+8。

{
  "Data": {
    "id": "usp2026ogkk",
    "infoTypeName": "",
    "magnitude": 5.1,
    "placeName": "智利北部",   // 经地名库按坐标转中文
    "shockTime": "2026-07-23 01:34:37",   // UTC+8
    "updateTime": "2026-07-23 01:34:37",
    "longitude": -68.26, "latitude": -23.29,
    "depth": 111.0, "source": "USP"
  },
  "md5": "..."
}

字段说明

德国 GFZ 全球地震目录，时间已转 UTC+8。

{
  "Data": {
    "id": "gfz2026ogmf",
    "infoTypeName": "",
    "magnitude": 5.1,
    "placeName": "克马德克群岛地区",   // 经地名库按坐标转中文
    "shockTime": "2026-07-23 02:29:39",   // UTC+8
    "updateTime": "2026-07-23 02:29:39",
    "longitude": -179.643, "latitude": -31.54,
    "depth": 367.6, "source": "GFZ"
  },
  "md5": "..."
}

字段说明

意大利地震情报，时间已转 UTC+8。

{
  "Data": {
    "id": "46630772",
    "infoTypeName": "",
    "magnitude": 0.6,
    "placeName": "5 km NE Nocera Umbra (PG)",
    "shockTime": "2026-07-23 10:16:26",   // UTC+8
    "updateTime": "2026-07-23 10:46:18",
    "longitude": 12.8352, "latitude": 43.1395,
    "depth": 17.3, "source": "INGV"
  },
  "md5": "..."
}

字段说明

美国 USGS 全球地震情报，时间已转 UTC+8；infoTypeName 为测定标识（automatic / reviewed）。

{
  "Data": {
    "id": "ci41026127",
    "infoTypeName": "reviewed",
    "magnitude": 2.6,
    "placeName": "加利福尼亚州南部",   // 经地名库按坐标转中文
    "shockTime": "2026-07-23 10:16:14",   // UTC+8
    "updateTime": "2026-07-23 10:22:35",  // UTC+8
    "longitude": -116.7711667, "latitude": 33.7043333,
    "depth": 16.3, "source": "USGS"
  },
  "md5": "..."
}

字段说明

欧洲地中海地震中心（EMSC）全球地震情报，实时推送，时间已转 UTC+8。

{
  "Data": {
    "id": "20260722_0000123",
    "infoTypeName": "",
    "magnitude": 5.1,
    "placeName": "克马德克群岛地区",   // 经地名库按坐标转中文
    "shockTime": "2026-07-23 02:29:39",   // UTC+8
    "updateTime": "2026-07-23 02:35:00",
    "longitude": -179.643, "latitude": -31.54,
    "depth": 367.6, "source": "EMSC"
  },
  "md5": "..."
}

字段说明

香港天文台显著地震报告，时间为 UTC+8；无独立 id、无 depth。

{
  "Data": {
    "id": "2026-07-17T23:20:00+08:00",
    "infoTypeName": "",
    "magnitude": 6.2,
    "placeName": "墨西哥恼帕斯近岸",
    "shockTime": "2026-07-17 23:20:00",   // UTC+8
    "updateTime": "2026-07-17 23:33:00",  // UTC+8
    "longitude": -93.22, "latitude": 14.37,
    "depth": 0.0, "source": "HKO"
  },
  "md5": "..."
}

字段说明

法国 BCSF-Rénass 地震目录（FDSNWS 实时事件），时间已转 UTC+8；不做过滤，全量转发。

{
  "Data": {
    "id": "fr2026ufugzr",          // FDSNWS EventID
    "infoTypeName": "",
    "magnitude": 5.5,
    "placeName": "印尼马鲁古海域",       // 经地名库按坐标转中文（未命中时保留原始英文）
    "shockTime": "2026-07-24 06:58:42",   // UTC+8
    "updateTime": "2026-07-24 06:58:42",  // UTC+8
    "longitude": 126.24, "latitude": 0.59,
    "depth": 90.5, "source": "BCSF"
  },
  "md5": "..."
}

字段说明

海啸预警（灾害预警），时间均为 UTC+8。嵌套结构，无 source 字段（仅在 /ws/all 转发时注入 source: "tsunami"）。

{
  "Data": {
    "id": "85585680e5aa4c22bf6b08ba087eac17",
    "code": "202512272305",           // 事件编号(同一海啸多次更新一致)
    "warningInfo": {
      "title": "海啸信息",
      "level": "信息",                    // 信息 / 解除 / 蓝色 / 黄色 / 橙色 / 红色
      "subtitle": "中国台湾省周边海域",
      "orgUnit": "自然资源部海啸预警中心"
    },
    "timeInfo": {
      "alarmDate": "2025-12-28 02:25:45",  // 发布时间 UTC+8
      "updateDate": "2025-12-28 01:53:10"  // 最近更新时间 UTC+8
    },
    "shockInfo": {                        // 震源参数，shockTime 由 code 推得，其余取自详情页
      "shockTime": "2025-12-27 23:05",
      "latitude": 24.67, "longitude": 122.06,
      "depth": 60, "magnitude": 6.6,
      "placeName": "中国台湾省周边海域"
    },
    "details": {
      "batch": "3",                       // 报次
      "logoUrl": "http://obs.nmefc.cn/CMS/warnLogo/海啸消息灰.png",
      "htmlUrl": "https://obs.nmefc.cn/.../202512272305_3.html",
      "maps": {
        "earthquakeMapUrl": "https://obs.nmefc.cn/.../Earthquake_Pos.jpg",
        "amplitudeMapUrl": "",           // 仅警报时有值
        "coastalMapUrl": ""              // 仅警报时有值
      }
    },
    "forecasts": [],                      // 信息/解除时为空数组
    "waterLevelMonitoring": []            // 信息/解除时为空数组
  },
  "md5": "a45588e9382c33c3422885ab9bcc611e"
}
// 警报级别时 forecasts / waterLevelMonitoring 含数据：
// forecasts[i]: {province, forecastArea, forecastPoint, estimatedArrivalTime(HH:mm), maxWaveHeight, warningLevel}
// waterLevelMonitoring[i]: {stationName, location, coordinates:{latitude,longitude}, time, maxWaveHeight(厘米)}

字段说明

实时气象预警（灾害预警），effective 为 UTC+8。扁平结构，无 source 字段（仅在 /ws/all 转发时注入 source: "weatheralarm"）。

{
  "Data": {
    "id": "44170041600000_20250425123759",
    "headline": "广东省阳江市发布暴雨橙色预警信号",
    "effective": "2025/04/25 12:37",       // 生效时间 UTC+8
    "description": "阳江市气象台...请注意防范。

防御指南：
1.政府及相关部门...；
2.学校、幼儿园...",  // 预警正文 + 防御指南(
 换行)
    "type": "p0002002",                     // 预警类型编码
    "title": "广东省阳江市发布暴雨橙色预警信号",
    "img": "https://image.nmc.cn/assets/img/alarm/p0002002.png"   // 预警图标地址
  },
  "md5": "93b33eaed88114560752c05707f58d54"
}

字段说明

日本气象厅（JMA）火山相关电文（源自 eqvol.xml Atom feed），涵盖喷发警报・预报、火山解说信息、喷发观测报、降灰预报与推定喷烟流向报。收到新报或更新后立即推送（内容变化才推）；时间为 UTC+9（日本时间，与 /ws/jma 一致）；火山名与电文正文为日语原文。首连补发最近 10 条。

{
  "Data": {
    "id": "VFVO52_20260724174700_506",  // 缓冲唯一键 = 电文代码_EventID
    "updates": 1,                        // 报数 (Serial)
    "kindCode": "VFVO52",               // 数据种类代码
    "kindName": "喷发相关火山观测报",     // 中文电文名
    "infoKind": "噴火に関する火山観測報",   // 日文电文名
    "infoTypeName": "発表",              // 発表 / 訂正 / 取消
    "title": "火山名　桜島　噴火に関する火山観測報",
    "reportTime": "2026-07-24 17:47:00", // 发报时刻 UTC+9
    "targetTime": "2026-07-24 17:39:00", // 现象时刻 UTC+9
    "volcanoName": "桜島",              // 火山名(日语原文)
    "volcanoCode": "506",
    "latitude": 31.5925, "longitude": 130.6567,  // 火山位置(十进制度)
    "elevation": 1117,                   // 海拔高度(米)
    "craterName": "南岳山頂火口",       // 火口名(可能为空)
    "headline": "火　　山：桜島...",     // Head 概要正文(无则回退 VolcanoHeadline，可能为空)
    "activity": "...噴火が発生...",      // 火山活动/降灰详述(含时段·方向·距离，可能为空)
    "prevention": "...",               // 防灾提示(可能为空)
    "nextAdvisory": "...",             // 下次发布预告(可能为空)
    "plumeDirection": "直上",          // 噴煙流向(可能为空)
    "plumeHeight": 1000,                // 火口上噴煙高度(米，无则为 0)
    "plumeHeightSea": 6800,             // 海抜噴煙高度(FT，无则为 0)
    "observation": "...",              // 观测补充(火口/噴煙量等，可能为空)
    "windTime": "2026-07-24 18:00:00",  // 高空风数据时刻 UTC+9(无则为空)
    "winds": [                          // 高空风垂直廓线(逐海拔高度，无则空数组)
      { "heightFt": 5000, "degree": 20, "speedKt": 11 }
      // ...
    ],
    "publishingOffice": "福岡管区気象台　鹿児島地方気象台"
  },
  "md5": "...",
  "source": "va"
}

数据种类代码

字段说明

聚合端点：转发情报/预警源（JMA-EEW / JMA / CWA-EEW / CWA / BMKG / GeoNet / TMD / USP / GFZ / INGV / USGS / EMSC / HKO / BCSF / tsunami / weatheralarm）的每一帧（不含 NIED / S-Net / KMA 实时震度），并在帧末尾追加 source 字段标明来源（短源名，取值如 usgs、bcsf、tsunami、weatheralarm）。首次连接时将各源最新一条合并为一个 JSON 数组（[{...},{...}]）一次性发送（同样不含 nied/snet/kma_station）；之后的实时推送为单个对象帧。海啸帧与气象预警帧在各自专用端点上无 source，在本端点会被注入 source: "tsunami" / source: "weatheralarm"。

// 首连补发（单个消息，数组）：
[{"Data":{...},"md5":"...","source":"jma"}, {"Data":{...},"md5":"...","source":"cwa"}, ...]

// 之后的实时推送（单个对象）：
{
  "Data": { ... },                // 与对应源推送的 Data 完全一致
  "md5": "...",
  "source": "usgs"               // 短源名，位于帧末尾（Data/md5 之后）
}