开发指南

新用户可测试2000次

国外主要城市7日天气接口 收费在线测试此接口(需要登录)


该接口2小时更新一次,支持全球6000多个城市和地区,返回最近7日天气,包含基本天气信息、每日小时天气,可按地名、城市编号、IP查询。

请求方式及url:

  • 请求方式:GET

  • 接口地址:https://tianqiapi.com/api

请求示例

https://tianqiapi.com/api?version=v5&appid=&appsecret=

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 固定值: v5 每个接口的version值都不一样
cityid string 城市ID 请参考 城市ID列表
city string 城市名称 例如: 堪培拉、纽约
ip string IP地址 查询IP所在城市天气
callback string jsonp参数 如: jQuery.Callbacks
vue string 跨域参数 如果您使用的是react、vue、angular请填写值: 1

备注

cityid、city和ip参数3选一提交,如果不传,默认返回当前ip城市天气,cityid优先级最高。

响应JSON

请点击 在线测试此接口(需要登录) 查看

响应参数说明

参数名 类型 说明 备注
cityid String 城市ID
update_time String 气象台更新时间
city String 城市名称 例如:纽约
cityEn String 城市英文名称 例如:New York
country String 国家名称 例如:美国
countryEn String 国家英文名称 例如:United States
data String 每日数据列表
 ┗ date String 当前日期
 ┗ wea String 天气情况 例如:晴
 ┗ wea_img String 天气对应图标 固定9种类型(您也可以根据wea字段自己处理):
xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
 ┗ tem1 String 白天温度 例如:18
 ┗ tem2 String 晚上温度 例如:-5
 ┗ win String 风向 例如:北风
 ┗ win_speed String 风力 例如:3-4级
 ┗ hours String 小时预报
      ┗ hours String 时间点 例如:20时
      ┗ wea String 天气
      ┗ wea_img String 天气图标
      ┗ tem String 温度
      ┗ win String 风向
      ┗ win_speed String 风力等级