自然灾害预警API - 枫霖的API服务

自然灾害预警API - 枫霖的API服务

自然灾害相关预警API,通过整合多个上游API内容,尽可能提供稳定、快速的服务

中国地震台网地震信息

提供中国地震台网地震信息(M≥3)与部分区域地震台网地震信息(M<3),需完成鉴权后方可接收数据

WSS wss://api.odysphere.tech/cenc
POST https://api.odysphere.tech/cenc

接口描述

本API服务聚合提供中国地震台网地震信息(M≥3)与部分区域地震台网地震信息(M<3),数据来源于中国地震台网,需完成鉴权后方可接收数据

鉴权说明

本接口需要使用 Token 鉴权。请前往 申请页面 填写使用用途,经许可后,管理者将通过回复邮件提供 Token。

HTTP 接口:使用 POST 方法,将 Token 作为 token 字段放入请求参数中提交(请求体),不通过 URL 传递。

WSS 接口:连接建立后,客户端应在 5 秒内发送该 Token 字符串,随后将立即收到最新一条地震信息。

接口列表

wss://api.odysphere.tech/cenc
WSS - 提供中国地震台网地震信息(M≥3)与部分区域台网地震信息(M<3)
https://api.odysphere.tech/cenc
POST - 提供近20条中国地震台网地震信息(M≥3)与部分区域台网地震信息(M<3)

WSS 数据示例

{
  "DataType":"湖南",
  "Data":{
    "eventId":"CA_20260609152909_R",
    "shockTime":"2026-06-09 15:18:27",
    "longitude":110.29,
    "latitude":29.14,
    "placeName":"湖南张家界市永定区(疑似塌陷)",
    "magnitude":"2.2",
    "depth":"0",
    "Type":"Reviewed"
  },
  "md5":"1ecdbe8569b33f19762fdc15ef5e626d"
}

HTTPS POST 请求示例

POST /cenc HTTP/1.1
Host: api.odysphere.tech
Content-Type: application/json

{
  "token": "your_token_string"
}

HTTPS POST 响应数据示例

[
    {
        "DataType": "中国",
        "Data": {
            "eventId": "CD_20260817040118_R",
            "shockTime": "2026-08-17 04:01:18",
            "longitude": 105.22,
            "latitude": 29.21,
            "placeName": "四川内江市隆昌市",
            "magnitude": 3.3,
            "depth": 10,
            "Type": "Reviewed"
        },
        "md5": "91cfcd18fbbc2cbd1a3547ee9cd4b984"
    },
    ......
    {
        "DataType": "中国",
        "Data": {
            "eventId": "CD_20260812134217_R",
            "shockTime": "2026-08-12 13:42:17",
            "longitude": 84.1,
            "latitude": 42.2,
            "placeName": "新疆巴音郭楞州轮台县",
            "magnitude": 3.8,
            "depth": 17,
            "Type": "Reviewed"
        },
        "md5": "afaf56a2b443fbd37cb43dc346c5c96f"
    }
]

字段说明

字段名 类型 说明
DataTypestring数据来源台网。根据上游数据确定。可能为:中国、湖南、广西、宁夏
Dataobject该地震事件数据组
Data.eventIdstring事件唯一ID,正式测定与自动测定不相同
Data.shockTimestring发震时间。(格式:YYYY-MM-DD HH:MM:SS)
Data.longitudenumber震中经度(浮点数)
Data.latitudenumber震中纬度(浮点数)
Data.placeNamestring震中地名。部分特定事件可能在震中名后携带特殊说明(例:(疑似塌陷))
Data.magnitudenumber震级(浮点数类型)
Data.depthnumber震源深度(整数类型),单位:km。该字段可能为 null
Data.Typestring测定类型。分为 Reviewed(正式测定)与 Auto(自动测定)
md5string数据唯一校验码,自动测定与正式测定不相同

特殊指令

获取多条历史数据
使用此指令可获取指定数量的历史地震数据组,最大支持20个
/list {数量}
发送以上指令后,将返回对应数量的历史地震数据,不携带数量则默认为20
示例回复
发送消息:/list 2
收到消息:
[
  {
    "DataType":"中国",
    "Data":{
      "eventId":"CD_20260722115253_R",
      "shockTime":"2026-07-22 11:45:36",
      "longitude":101.45,
      "latitude":23.2,
      "placeName":"云南普洱市墨江县",
      "magnitude":3.1,
      "depth":10,
      "Type":"Reviewed"
    },
    "md5":"fc70b58d1865b7bb21a7ba11ccca7e4b"
  },
  {
    "DataType":"中国",
    "Data":{
      "eventId":"CD_20260722051445_R",
      "shockTime":"2026-07-22 05:14:45",
      "longitude":101.44,
      "latitude":23.21,
      "placeName":"云南普洱市墨江县",
      "magnitude":3.3,
      "depth":9,
      "Type":"Reviewed"
    },
    "md5":"4ce77ade135d58b5f947a25ad14e048f"
  }
]

使用说明

免责声明:本API不提供任何SLA保证,因此也不对因数据延迟、错误或不完整等情况造成的直接或间接损失负责,使用时即代表知晓并同意。