一周天气预报API接口
  • 72
  • 10217

天气预报

一周天气预报API接口按次计费正常调用
  • 该接口申请即送2000次免费调用额度
  • 接口价格:1天行币一次(0.0001元)
    查询七天的天气预报情况,支持城市名称和IP地址查询,两个参数都没填的情况下,默认为请求IP所在地的天气。该接口每60分钟更新一次缓存,查询空气质量请使用空气质量指数接口、天气图标请点此下载

    可以和天气诗句接口配合使用,让你的天气应用更有意境。唯美天气诗句API

    ▼ 接口信息
  • 接口地址:http://api.tianapi.com/txapi/tianqi/index
  • 请求示例:http://api.tianapi.com/txapi/tianqi/index?key=APIKEY&city=上海
  • 支持协议:HTTP/HTTPS
  • 请求方式:GET/POST
  • 返回格式:UTF8 JSON
▼ 请求参数

post请求时,enctype应为application/x-www-form-urlencoded

名称类型必填位置示例值说明
keystringurlParam用户自己的APIKEYAPI密钥
citystringurlParam上海城市名称,不要带“市”
ipstringurlParam116.234.222.36IP地址
▼ 返回示例
▼ 返回参数
名称类型示例值说明
areastring上海地区
datestring2020-03-23日期
weekstring星期一星期
weatherstring晴转多云早晚天气变化
weatherimgstringyun.png天气图标
realstring18℃实时天气
loweststring6℃最低温
higheststring22℃最高温
windstring东南风风向
winddegstring121风向360°角度
windspeedstring7风速,km/h
windscstring1-2级风力
sunrisestring06:10日出时间
sunsetstring18:31日落时间
moonrisestring06:02月升时间
moondownstring17:22月落时间
pcpnstring0.0降雨量
popstring1降雨概率
uv_indexstring9紫外线强度指数
visstring9能见度,单位:公里
humiditystring23相对湿度
tipsstring天气暖和,适宜着单层......生活指数提示
▼ 接口价格
用户等级每日赠送次数会员价格说明
提示:本接口为按次计费接口,任何会员等级每次调用价格均为1天行币,增加调用次数请点此充值
▼ 错误状态码
错误代码错误消息解释帮助
100内部服务器错误出现此错误码请及时反馈或等待修复
110接口暂时维护中接口暂时关闭维护中,请注意相关公告
120IP请求来源受限设置了IP白名单
130API调用频率超限API超出了分钟频率限制
140API没有调用权限该API只有特定用户才可以调用,也可能是被禁用
150接口可用次数不足接口可用次数不足,请在接口列表查看
160账号未申请该接口请先在对应的接口详情页面申请接口
170Referer请求来源受限设置了Referer防盗用功能
230key错误或为空请检查apikey是否填写错误或未正确传递
240缺少key参数请检查是否传递了key参数,如变量请检查是否赋值
250数据返回为空数据查询或转换失败
260关键词不得为空word参数不要传递null或空值
270缺少有效数据部分接口需要传递数据,请按接口说明来
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过资源字节限制超过了最大输入字节限制
1开头的是系统级错误,2开头的是用户级错误,其中200代码表示数据请求成功。
▼ 参考代码

其他可直接使用的部分开源项目推荐。另外此处的参考代码都是get方式请求,post请求请参考此项目

活动推荐EXERCISE API 更多>

开通会员专享福利
留言反馈