天气查询
<h5>简要描述</h5>
<ul>
<li>支持全国实时详细天气、未来七天天气、未来实时天气查询</li>
</ul>
<p><strong>请求URL：</strong></p>
<ul>
<li><code>https://api.toer2.com/tianqi</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>参数：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">appid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>用户UID</td>
<td>个人中心获取</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>查询地区</td>
<td>北京</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>查询类型代码（参考下方）</td>
<td>location:weather</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名密钥</td>
<td>参见下方</td>
</tr>
</tbody>
</table>
<pre><code>签名密钥：MD5加密(appid + city + type + key)</code></pre>
<blockquote>
<p>签名密钥加密方式具体请参考接口简要概述</p>
</blockquote>
<p><strong>查询类型：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">类型名称</th>
<th style="text-align: left;">类型代码</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">实时详细天气</td>
<td style="text-align: left;">city:tianqi</td>
</tr>
<tr>
<td style="text-align: left;">当前实时天气</td>
<td style="text-align: left;">location:weather</td>
</tr>
<tr>
<td style="text-align: left;">未来七天天气</td>
<td style="text-align: left;">location:weather/forecast</td>
</tr>
<tr>
<td style="text-align: left;">未来小时天气</td>
<td style="text-align: left;">location:weather/hourly</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 1005,
"msg": {
"code": 200,
"msg": "success",
"data": {
"basic": {
"cid": "CN101010100",
"location": "北京",
"parent_city": "北京",
"admin_area": "北京市",
"cnty": "中国",
"lat": "39.904987",
"lon": "116.405289",
"tz": "+8.00"
},
"update": {
"loc": "2021-07-10 14:47",
"utc": "2021-07-10 06:47"
},
"status": "ok",
"now": {
"cloud": "91",
"cond_code": "101",
"cond_txt": "多云",
"fl": "34",
"hum": "64",
"pcpn": "0.0",
"pres": "998",
"tmp": "31",
"vis": "8",
"wind_deg": "45",
"wind_dir": "东北风",
"wind_sc": "2",
"wind_spd": "8"
}
},
"time": 1625900013,
"log_id": 272378156493807600
}
}
</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td>返回状态码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">array</td>
<td>天气数据</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
<li>结果页面参考：<a href="https://www.toer2.com/tianqi.html">https://www.toer2.com/tianqi.html</a></li>
</ul>
<p>欢迎使用兔二API！</p>