天气预警推送服务说明文档-接口盒子

📋 基础信息

POST 推送方式

JSON 数据格式

⚡ 系统会通过 HTTP POST 请求将天气预警数据以 JSON 格式推送到您设置的接收地址。

✅ 收到数据后，请务必在响应中返回数字 200，否则系统会认为推送失败并尝试重新推送。

📄 数据示例

{
    "code": 200,
    "yjid": "33078241600000_20260411110443",
    "sheng": "浙江",
    "shi": "义乌",
    "name": "义乌",
    "sheng2": "浙江省",
    "shi2": "金华市",
    "qu2": "义乌",
    "place": "义乌市",
    "code5": "330782",
    "title": "义乌市气象台发布雷电黄色预警[Ⅲ级/较重]",
    "signaltype": "雷电",
    "signallevel": "黄色",
    "effective": "2026/04/11 10:58",
    "eventType": "11B14",
    "severity": "YELLOW",
    "type": "p0012003",
    "msg": "义乌市气象台2026年4月11日10时58分发布雷电黄色预警信号：受强对流云团影响，预计未来24小时我市所有镇（街道）将出现雷电活动，并可伴有短时强降水等强对流天气，请注意防范雷击带来的不利影响。（预警信息来源：国家预警信息发布中心）"
}

🔍 字段说明

字段名	说明	示例值
code	状态码，始终为 200	200
yjid	预警编号，唯一标识符	33078241600000_20260411110443
sheng	省级行政区（简称）	浙江
shi	市级行政区/或某个地点	义乌
name	地点名称	义乌
sheng2	省级行政区全称（带省后缀）	浙江省
shi2	市级行政区全称（带市后缀）	金华市
qu2	区县级行政区	义乌
place	关键地点，可能存在多个，以竖杠分割	长宁区\|宝山区
code5	行政区划代码	330782
title	预警标题	义乌市气象台发布雷电黄色预警[Ⅲ级/较重]
signaltype	预警天气类别	雷电
signallevel	预警等级（中文）	黄色
effective	预警生效时间	2026/04/11 10:58
eventType	事件类型代码	11B14
severity	预警等级（英文）	YELLOW
type	预警类型代码	p0012003
msg	详细的预警内容	义乌市气象台2026年4月11日10时58分发布...

💻 PHP 接收示例

✅ 以下是一个简单的 PHP 接收示例，您可以根据实际需求进行调整：

// 接收天气预警推送数据
<?php

// 获取 POST 请求的原始数据
$postData = file_get_contents('php://input');

// 将 JSON 数据解码为数组
$datares = json_decode($postData, true);

// 检查 JSON 解码是否成功
if (json_last_error() === JSON_ERROR_NONE) {  
    // 获取状态码
    $code = $datares['code'];
    
    // 如果状态码为 200，处理预警数据
    if($code == 200) {
        // 在这里编写您的业务逻辑
        // 例如：保存到数据库、发送通知等
        


    }
}

// 必须返回 200 表示接收成功
echo 200;

// 重要提示：如果不返回 200，该条信息将多次重复推送
?>

💡 重要提示：

接收程序处理完成后，必须返回数字 200 作为响应，否则推送服务器会认为推送失败并进行重试。

🌀 天气预警推送服务