天气预报

一周天气预报API接口
  • 接口价格:1天行币(0.0001元/次)
  • 赠送次数:30000
  • 接口地址:http://api.tianapi.com/txapi/tianqi/(请不要省略末尾的斜杠)
  • 请求方式:HTTP/HTTPS GET
  • 返回格式:JSON

查询七天的天气预报情况,支持城市名称和IP地址查询,两个参数都没填的情况下,默认为请求IP所在地的天气。该接口每2小时更新一次缓存。天气图标下载

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

▼ 接口价格
用户等级初始额度每日赠送可调用次数备注说明
普通用户300000永久30000次新用户注册赠送的永久额度
高级会员3000010000永久30000次+每日10000次开通会员即享永久额度+每天赠送额度
黄金会员3000050000永久30000次+每日50000次开通会员即享永久额度+每天赠送额度

* 额度单位是天行币(1W天行币/元),会员用户优先使用每日赠送的额度,如需更高额度或不限次请联系我们。

▼ 请求参数
请求参数类型必填参数位置示例值备注说明
keystringurlParam用户自己的APIKEYAPI密钥
citystringurlParam上海城市名称,不要带“市”
ipstringurlParam116.234.222.36IP地址
▼ 返回示例
▼ 返回参数
返回参数类型示例值备注说明
dateDate2019-05-13时间
weekstring星期一星期
weatherstring小雨转多云天气
weatherimgstringyun.png天气图标
loweststring25℃最高温
higheststring18℃最低温
windstring西北风风向
windspeedstring<3级风力
airint57空气质量指数
air_levelstring空气质量等级
tipsstring空气好,可以外出活动......天气状况提示
▼ 错误状态码
错误代码错误消息解释帮助
100内部服务器错误出现此错误码请及时反馈或等待修复
110接口暂时维护中接口暂时关闭维护中,请注意相关公告
120IP请求来源受限设置了IP白名单
130API调用频率超限API超出了分钟频率限制
140API没有调用权限该API只有会员或特定用户才可以调用
150天行币余额不足账号天行币余额不足,请在个人中心查看
160账号未申请该接口请先在对应的接口详情页面申请接口
230key错误或为空请检查apikey是否填写错误或未正确传递
240缺少key参数请检查是否传递了key参数,如变量请检查是否赋值
250数据查询失败数据查询或转换失败
260关键词不得为空word参数不要传递null或空值
270缺少有效数据部分接口需要传递数据,请按接口说明来
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过资源字节限制超过了最大输入字节限制
▼ 参考代码
留言反馈