单点查询 API

Access Restriction

This API is a premium service available only to enterprise tier developers. Please contact Caiyun Sales to purchase.

TIP

目前支持中国、日本的气象预警信息，其他国家和地区的预警信息正在逐步增加中。

每次调用消耗接口调用额度一次。

Errors | Coverage and Data Granularity

Request

http

GET https://singer.caiyunhub.com/v3/alert/location

Query Parameters

Name	Required	Default	Range	Description
`token`	Yes	—	—	API token; see Authentication
`longitude`	Yes	—	—	Longitude
`latitude`	Yes	—	—	Latitude

Request Example

bash

curl "https://singer.caiyunhub.com/v3/alert/location?token={token}&longitude=121.4457&latitude=31.2557"

Response Example

json

{
  "alerts": [
    {
      "id": "ALERT_CN_31000041600000_20250811152835", // 业务分配的唯一标识
      "region_code": "CN", // ISO 3166-1 Alpha-2 code
      "area_code": "310000", // 区域编码
      "source": 1, // 预警来源机构，参考 AlertSource
      "alert_type": 156110214, // 预警类型，参考 AlertType
      "publish_time": 1754896800, // 预警发布时间戳（秒）
      "color": {
        "red": 250,
        "green": 230,
        "alpha": {
          "value": 1
        }
      },
      "data": [
        {
          "language_code": "zh-CN", // 语言编码
          "title": "上海中心气象台发布雷电黄色预警[Ⅲ级/较重]", // 预警名称
          "text": "上海中心气象台2025年08月11日15时20分发布雷电黄色预警[Ⅲ级/较重]：预计今天半夜以前，全市大部地区将发生雷电活动，可能会造成雷电灾害事故，请注意防范。（数据来源：国家预警信息发布中心）", // 预警内容
          "level": "yellow", // 预警级别，该字段不一定都有，慎用
          "name": "雷电黄色预警" // 预警标题
        }
      ]
    },
    {
      "id": "ALERT_CN_31000041600000_20250811122929",
      "region_code": "CN",
      "area_code": "310000",
      "source": 1,
      "alert_type": 156110209,
      "publish_time": 1754886180,
      "color": {
        "red": 240,
        "green": 150,
        "blue": 20,
        "alpha": {
          "value": 1
        }
      },
      "data": [
        {
          "language_code": "zh-CN",
          "title": "上海中心气象台发布高温橙色预警[Ⅱ级/严重]",
          "text": "上海中心气象台2025年08月11日12时23分发布高温橙色预警[Ⅱ级/严重]：预计全市大部地区今天的最高气温将超过37℃，高温黄色预警信号更新为高温橙色预警信号，请注意防范强高温对工农业生产、人体健康的不利影响，确保生产、消防、用电等方面的安全。（数据来源：国家预警信息发布中心）",
          "level": "orange",
          "name": "高温橙色预警"
        }
      ]
    }
  ]
}

Response Fields

Alerts

JSONPath	Type	Description
`$.alerts`	`array<AlertRecord>`	Alert records

AlertRecord

Field	Type	Description
`alert_type`	`AlertType`	Alert type
`area_code`	string	Area code, which may be an administrative code or a code assigned by the relevant organization
`color`	object	Color defined by the issuing meteorological agency; zero RGBA values may be omitted, and `alpha` differs slightly in webhook data
`data`	`array<AlertData>`	Localized alert information
`id`	string	Unique business identifier; do not parse it for business logic
`publish_time`	number	Publish time as a Unix timestamp in seconds
`region_code`	string	ISO 3166-1 Alpha-2 code
`source`	`AlertSource`	Issuing organization
`status`	number	`1` issued, `2` continued, `3` canceled, or `4` expired; `3` and `4` are provided only through webhook pushes

AlertData

Field	Type	Description
`language_code`	string	Language code
`level`	string	Localized alert level
`name`	string	Alert name
`text`	string	Alert content
`title`	string	Alert title

AlertSource

随时可能新增枚举值，代码请做好兼容处理。

Number	Description
1	中国气象局
2	日本气象厅

AlertType

随时可能新增枚举值，代码请做好兼容处理。

枚举值以 ISO 3166-1 numeric-3 code 开头，后面跟随具体的预警类型。比如如下表格里，中国的前缀为 156，日本的前缀为 392。

Number	Description
156100000	突发事件
156110000	自然灾害
156110100	水旱灾害
156110101	洪水
156110108	枯水
156110109	中小河流洪水和山洪气象风险
156110151	山洪灾害事件
156110152	农业干旱
156110154	生态干旱
156110200	气象灾害
156110201	台风事件
156110202	龙卷风事件
156110203	暴雨事件
156110204	暴雪事件
156110205	寒潮事件
156110206	大风事件
156110207	沙尘暴事件
156110208	低温冻害事件
156110209	高温事件
156110210	热浪事件
156110211	干热风
156110212	下击暴流事件
156110213	雪崩事件
156110214	雷电事件
156110215	冰雹事件
156110216	霜冻事件
156110217	大雾事件
156110218	低空风切变事件
156110219	霾
156110220	雷雨大风
156110221	道路结冰
156110222	干旱
156110223	海上大风
156110224	高温中暑
156110225	森林火险
156110226	草原火险
156110227	冰冻
156110229	重污染
156110230	低温雨雪冰冻
156110231	强对流
156110232	臭氧
156110233	大雪
156110234	寒冷
156110235	连阴雨
156110236	渍涝风险
156110237	地质灾害
156110238	强降雨
156110239	强降温
156110240	雪灾
156110241	森林（草原）火险
156110243	雷暴
156110247	春季沙尘天气趋势预警
156110248	降温
156110249	台风暴雨
156110250	严寒
156110251	沙尘
156110252	海上雷雨大风预警信号
156110254	海上雷电预警信号
156110255	海上台风预警信号
156110256	低温
156110257	道路冰雪
156110258	雷暴大风
156110262	海区大风
156110265	海区大雾
156110286	低温凝冻
156110287	低温冷害
156110291	低温冰冻
39200010	大雨
39200020	大雪
39200030	風雪
39200040	雷
39200050	強風
39200060	波浪
39200070	融雪
39200080	洪水
39200090	高潮
39200100	濃霧
39200110	乾燥
39200120	なだれ(雪崩)
39200130	低温
39200140	霜
39200150	着氷
39200160	着雪
39200170	暴風雪
39200180	暴風

预警颜色说明

《GB/T 37230—2018》定义了中国预警颜色规范，其中颜色等级对照如下：

等级	颜色	RGB 值
广东特有预警级别	白色	255/255/255
IV 级（一般）	蓝色	55/100/255
III 级（较重）	黄色	250/230/0
II 级（严重）	橙色	240/150/20
I 级（特别严重）	红色	220/40/40

单点查询 API ​

Request ​

Query Parameters ​

Request Example ​

Response Example ​

Response Fields ​

Alerts ​

AlertRecord ​

AlertData ​

AlertSource ​

AlertType ​

预警颜色说明 ​