覆盖全国2000+城市
实时天气数据
7天天气预报
生活指数
空气质量指数
分钟级更新
天气类应用开发
旅游出行规划
智能家居联动
农业生产参考
户外活动安排
健康生活提醒
详细的接口参数说明和响应示例
https://api.t0.com.cn/weather
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
city |
string | 是 | 城市名称，如：北京、上海、广州等 |
type |
string | 否 | 天气类型，可选值：now(实时天气)、forecast(天气预报)、all(全部)，默认为now |
{
"code": 200,
"message": "查询成功",
"data": {
"city": "北京",
"update_time": "2023-04-01 12:00:00",
"now": {
"temp": "25",
"weather": "晴",
"wind_direction": "东南风",
"wind_power": "3级",
"humidity": "40%"
},
"forecast": [
{
"date": "2023-04-01",
"week": "星期六",
"weather": "晴",
"temp_high": "28",
"temp_low": "15"
},
{
"date": "2023-04-02",
"week": "星期日",
"weather": "多云",
"temp_high": "26",
"temp_low": "14"
}
]
}
}| 参数名 | 类型 | 说明 |
|---|---|---|
code |
integer | 状态码，200表示成功，其他表示失败 |
message |
string | 状态描述 |
data |
object | 返回数据 |
多语言调用示例，帮助您快速集成
fetch("https://api.t0.com.cn/weather?city=北京", {
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
})
.then(response => response.json())
.then(data => {
console.log(data);
})
.catch(error => {
console.error("Error:", error);
});<?php
$url = "https://api.t0.com.cn/weather?city=北京";
$headers = [
"Authorization: Bearer YOUR_API_KEY"
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>关于API使用的常见问题解答
您需要先注册成为我们的开发者，然后在开发者中心创建应用，系统会自动为您生成API密钥。每个应用对应一个API密钥，您可以根据不同的项目创建多个应用。
免费API每天有调用次数限制，具体限制请参考各API的说明。付费API根据您购买的套餐不同，有不同的调用次数限制。企业用户可以联系我们定制专属方案，满足大规模调用需求。
当API返回非200状态码时，表示调用出现错误。您可以根据返回的错误码和错误信息进行相应处理。常见错误包括参数错误、认证失败、调用次数超限等。详细的错误码说明请参考API文档。
您可以在开发者中心的"套餐管理"页面查看当前套餐并进行升级。我们提供多种套餐选择，满足不同规模的需求。如需定制套餐，请联系我们的客服团队。