天气预报查询
环境天气支持全国以及全球多个城市的天气查询,包含国内3400+个城市以及国际4万个城市的实况数据,同时也支持全球任意经纬度查询,接口会返回该经纬度最近的站点信息;更新频率分钟级别。
·服务保障·正规企业商品来源·交易流程全程监控
正在载入...
天气预报查询API文档
API 列表
身份认证
APISpace 的所有 API 均使用 API 密钥来验证请求。您可以在 访问控制页面 中查看和管理您的 API 密钥。
您的 API 密钥非常重要,因此请务必确保它们的安全!不要在可公开访问的区域(例如 GitHub、前端代码、客户端代码等)中存储或公开您的 API 密钥。
对 API 发出的所有请求都必须包含一个名为 “X-APISpace-Token” 的自定义 HTTP 头部(Header)。如果您的请求没有包含该自定义头部,或者该头部的Token参数不符合要求,则该 API 请求会失败。
频率限制
同时如果您的请求次数已经达到订阅套餐的限制,APISpace也会返回错误提示,此时的HTTP状态码为416,你可以升级订阅套餐或者额外购买独立的流量包来解决该问题。
状态码
系统级状态码
HTTP 状态码 | 系统状态码 | 描述 |
---|---|---|
416 | 10001 | 尚未购买该 API 或 API 调用次数已用完 |
401 | 10002 | Header 参数中找不到 X-APISpace-Token 或 X-APISpace-Token 非法 |
413 | 10003 | 请求频率过高 |
403 | 10004 | 请求来源非法,不在白名单中 |
504 | 10006 | 网关超时,请联系 APISpace 客服 |
404 | 10007 | 接口不存在 |
400 | 10010 | 无法识别请求内容,请检查请求体是否正确 |
400 | 10011 | 请求头部缺少 Content-Type 字段 |
400 | 10011 | 请求头部 Content-Type 字段错误 |
400 | 10014 | 批量参数超出单次批量数量的最大限制 |
400 | 10016 | 参数缺少内容 |
500 | 10017 | 参数类型错误 |