Skip to content

预警 Webhook 推送

输入

Webhook URL 接收的请求(POST, 30s 超时):

POST

json
{
  "event": "ALERT_OFF", // 目前包含: ALERT_ON, ALERT_OFF (一般只要发送 ALERT_ON 的提醒就行了)
  "nonce": "07ef789075c84e408b9d55c8248237a0", // 随机码
  "url": "https://api.caiyunapp.com/v1/alert/nmc_65230141600000_20181030180824",
  "time": "2018-10-30T18:00:00+08:00", // 预警发布时间
  "alert_id": "65230141600000_20181030180824", // Alert ID
  "signature": "bbf86640bf674e585c38ffad683a56e0994aaf19" // 签名
  // 计算方式 signature = sha1(client_secret + alert_id + nonce).hexdigest
}

其中 API 内容:

bash
curl "https://api.caiyunapp.com/v1/alert/ac_61062641600000_20181024142314?token=TOKEN"
json
{
  "status": "ok",
  "alert": {
    "status": "预警解除", // 预警状态, 包含: 预警中,预警解除
    "province": "陕西省",
    "code": "1101", // 预警code字段,格式为AABB
    "region_id": "101110312",
    "county": "吴起县",
    "alert_id": "ac_61062641600000_20181024142314",
    "description": "吴起县气象台2018年10月24日14时25分解除霜冻蓝色预警信号。", // 预警内容
    "latlon": [36.927216, 108.175933],
    "city": "延安市",
    "published_time": "2018-10-24T14:27:00+08:00", // 预警发布时间, 格式为 ISO 8601
    "published_timestamp": 1540908348, // 预警发布时间, 格式为时间戳
    "ad_code": "610626",
    "title": "吴起县气象局解除霜冻蓝色预警[IV级/一般]", // 预警标题
    "location": "陕西省延安市吴起县",
    "expired_time": "2018-10-25T14:27:00+08:00", // 预警过期时间, 格式为 ISO 8601
    "expired_timestamp": 1540908348 // 预警过期时间, 格式为时间戳
  }
}

编码规则

预警类型和预警等级对照表只表示截止于文档更新时的类型,代码里请做好兼容处理可能会返回的文档里没有标识的信息。

预警代码取自 code 字段,预警代码的前两位是预警信息类型,预警代码的后两位是预警级别。举例:"code": "0901”,可以分解出结构:预警类型编码+预警级别编码,于是我们得到雷电蓝色预警。

类型编码对照表

代号名称
01台风
02暴雨
03暴雪
04寒潮
05大风
06沙尘暴
07高温
19干热风
09雷电
10冰雹
11霜冻
12大雾
13
16雷雨大风
14道路结冰
08干旱
20海上大风
21高温中暑
15森林火险
22草原火险
23重污染
24强对流
25大雪
26寒冷
27强降雨
28雪灾
29森林(草原)火险
17春季沙尘天气趋势预警
30降温
18沙尘
31海上雷雨大风
32海上大雾
33低温
34道路冰雪
35雷暴大风
36持续低温
37森林火险气象风险
38地质灾害气象风险
39森林火险预警
40高森林火险
41高森林火险天气警报

级别编码对照表

预警级别级别编码
白色00
蓝色01
黄色02
橙色03
红色04