接口目录
接口文档
国内天气查询接口
更新时间:2023-04-07 接口状态:正常 按量计费专业会员免费

查询国内3400+个城市天气

本站所有充值均不含税,如需开票,请联系客服!

专业会员

选择开通时长:

¥ 380 / 1 年
¥ 38 / 1 月
年付会员 10000 次 / 天, 月付会员 3000 次 / 天
注1:会员一经购买,概不退款。会员权益如未使用,逾期作废。全站会员指标注会员免费的产品,不支持全站会员的产品无法免费。
¥ 100 / 1 年
¥ 30 / 3个月
¥ 10 / 1个月
年付会员 10000 次 / 天, 月付会员 3000 次 / 天

输入充值金额:

¥
元
点
¥ 50.00 / 50000 点 ( 预计可使用本接口 5000 次 )
注意:点数有效期2年。
注册即送 50 次,免费额度用完后 ≈ 10点 / 次 或 开通专业会员

接口地址:https://api.itapi.cn/api/tianqi

返回格式:application/json

请求方式:HTTPSGET

请求参数:

参数名称 类型 必填 说明
key string 是 用户请求密钥,可在 密钥管理页面 申请
citystring是城市名称(默认根据请求IP地址所在城市)
ipstring是IP地址(和城市名称参数二选一)

返回参数:

参数名称 类型 说明
citystring南昌
city_enstringnanchang
provincestring江西
province_enstringjiangxi
city_idstring101240101
update_timestring2022-10-24 15:30:59
weatherstring晴
weather_codestringqing
tempstring22
min_tempstring18
max_tempstring25
windstring东风
wind_speedstring2级
wind_scalestring6km/h
rainstring0
rain_24hstring0
humiditystring42%
visibilitystring20km
pressurestring1014
tail_numberstring
airstring48
air_pm25string33
sunrisestring06:22
sunsetstring17:38
aqistringair_level|空气等级,aqi.air_tips|出行提示,aqi.pm25|pm25,aqi.pm10|pm10,aqi.co|co,aqi.no2|no2,aqi.so2|so2,aqi.o3|o3
alarmstring
hourstring小时天气

系统错误代码:

代号 说明
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 你的密钥"
            }
        }
    }
}
说明:完整接入教程、SSE 用法与更多客户端写法见 MCP 接入说明;工具列表可通过 tools/list 获取,本站全部接口都会映射为一个工具。