天气查询 - API详情

计费信息

Pricing

免费

此接口完全免费

无需账户余额即可调用，仅需有效密钥

请求地址

Endpoint

正式地址

https://www.tiax.pw/API/weather.php

示例地址

https://www.tiax.pw/API/weather.php?city=邯郸市(如果查询北京顺义区只需要输入顺义即可)&type=text&apikey=你的key

请求参数

Parameters

参数名	类型	必填	说明
city	string	可选	城市名（北京）
apikey	string	可选	你的key
type	string	可选	text或者json

返回示例

Response

{ "code": 200, "msg": "北京当前天气：局部多云，温度 23.2℃，风速 8.2 km\/h，风向 144°，更新时间 2026-05-18T18:15", "data": { "city": "北京", "country": "中国", "province": "北京市", "latitude": 39.9075, "longitude": 116.39723, "weather": "局部多云", "temperature": 23.2, "windspeed": 8.2, "winddirection": 144, "time": "2026-05-18T18:15" } }

在线测试

Tester

返回结果

点击"立即测试"查看返回结果...

调用示例

Code Examples

<?php
$url = 'https://www.tiax.pw/API/weather.php';
$params = [
    'city' => 'YOUR_VALUE',
    'apikey' => 'YOUR_VALUE',
    'type' => 'YOUR_VALUE',
];
$url .= '?' . http_build_query($params);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

import requests

url = "https://www.tiax.pw/API/weather.php"
params = {
    'city': 'YOUR_VALUE',
    'apikey': 'YOUR_VALUE',
    'type': 'YOUR_VALUE',
}

response = requests.get(url, params=params)
print(response.text)

const url = new URL('https://www.tiax.pw/API/weather.php');
const params = {
    'city': 'YOUR_VALUE',
    'apikey': 'YOUR_VALUE',
    'type': 'YOUR_VALUE',
};

Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

fetch(url)
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

curl -X GET "https://www.tiax.pw/API/weather.php?city=YOUR_VALUE&apikey=YOUR_VALUE&type=YOUR_VALUE"

状态码说明

Status Codes

200	请求成功
403	拒绝访问 (缺少密钥或权限不足)
404	资源未找到 (检查 URL)
429	请求过于频繁 (触发限流)
500	服务器内部错误