接口目录
接口文档
查询国内3400+个城市天气
选择开通时长:
输入充值金额:
接口地址:https://api.itapi.cn/api/tianqi
返回格式:application/json
请求方式:HTTPSGET
请求参数:
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 用户请求密钥,可在 密钥管理页面 申请 |
| city | string | 是 | 城市名称(默认根据请求IP地址所在城市) |
| ip | string | 是 | IP地址(和城市名称参数二选一) |
返回参数:
| 参数名称 | 类型 | 说明 |
|---|---|---|
| city | string | 南昌 |
| city_en | string | nanchang |
| province | string | 江西 |
| province_en | string | jiangxi |
| city_id | string | 101240101 |
| update_time | string | 2022-10-24 15:30:59 |
| weather | string | 晴 |
| weather_code | string | qing |
| temp | string | 22 |
| min_temp | string | 18 |
| max_temp | string | 25 |
| wind | string | 东风 |
| wind_speed | string | 2级 |
| wind_scale | string | 6km/h |
| rain | string | 0 |
| rain_24h | string | 0 |
| humidity | string | 42% |
| visibility | string | 20km |
| pressure | string | 1014 |
| tail_number | string | |
| air | string | 48 |
| air_pm25 | string | 33 |
| sunrise | string | 06:22 |
| sunset | string | 17:38 |
| aqi | string | air_level|空气等级,aqi.air_tips|出行提示,aqi.pm25|pm25,aqi.pm10|pm10,aqi.co|co,aqi.no2|no2,aqi.so2|so2,aqi.o3|o3 |
| alarm | string | |
| hour | string | 小时天气 |
系统错误代码:
| 代号 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 限制或者错误 |
| 403 | 权限问题 |
| 500 | 服务器内部错误 |
| 按量套餐 | 套餐规格 | 价格 | ||
|---|---|---|---|---|
| 所有会员 | 10000次/天 | 10点 / 次 | ≈0.01元 / 次 | |
| * 点数支持所有标注为按量计费的产品抵扣。 | ||||
| 包月套餐 | 套餐规格 | 价格 | ||
|---|---|---|---|---|
| 一个月 | 3000次 / 天 | 10 元 / 月 | - | |
| 一季度 | 3000次 / 天 | 30 元 / 季 | - | |
| 一年 | 10000次/天 | 100 元 / 年 | - | |
| 会员套餐 | 套餐规格 | 价格 | ||
|---|---|---|---|---|
| 免费会员 | 50次 | 0.00 元 | - | |
| 月付会员 | 3000次 / 天 | 38 元 / 月 | - | |
| 年付会员 | 10000次/天 | 380 元 / 年 | - | |
| * 专业会员指标注会员免费的产品,不支持专业会员的产品无法免费。 | ||||
本站接口已整体接入 MCP(Model Context Protocol)。把下面的端点填进支持 MCP 的客户端(Cherry Studio、Cursor、Claude Desktop 等),即可让大模型以「工具」的方式调用本接口;调用等同于用你的密钥请求本接口,鉴权、计费、限流、日志与直接调用接口完全一致。
MCP 端点:https://api.itapi.cn/mcp
本接口工具名:tianqi(由接口路径自动生成)
鉴权方式:请求头 Authorization: Bearer 你的密钥
工具参数:
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| city | string | 否 | 城市名称(默认根据请求IP地址所在城市) |
| ip | string | 否 | IP地址(和城市名称参数二选一) |
* 密钥 key 由鉴权请求头传递,不作为工具参数填写。 | |||
调用示例(JSON-RPC):
复制{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tianqi",
"arguments": {
"city": "<city>",
"ip": "<ip>"
}
}
}
cURL 调用:
复制curl -X POST 'https://api.itapi.cn/mcp' \
-H 'Authorization: Bearer 你的密钥' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tianqi","arguments":{"city":"<city>","ip":"<ip>"}}}'
Python 调用:
复制import requests
url = 'https://api.itapi.cn/mcp'
headers = {'Authorization': 'Bearer 你的密钥', 'Content-Type': 'application/json'}
payload = {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tianqi","arguments":{"city":"<city>","ip":"<ip>"}}}
print(requests.post(url, json=payload, headers=headers, timeout=60).json())
客户端配置:
复制{
"mcpServers": {
"itapi": {
"type": "streamable-http",
"url": "https://api.itapi.cn/mcp",
"headers": {
"Authorization": "Bearer 你的密钥"
}
}
}
}
tools/list 获取,本站全部接口都会映射为一个工具。