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