预警 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 |