禁止未经允许的异常访问
禁止未经允许的异常访问,例如大规模压力测试等。合作方的异常访问行为,经评估会影响 API 正常工作或关键指标,在通知该合作方后,华风爱科有权临时停用该合作方的接口账号。
华风爱科开放 API 服务平台接口调用规范和要求
请您在开发前仔细逐条阅读以下开发规范,如违反以下标注为「必须项」的规则将有可能导致系统自动停用您的账号。
禁止未经允许的异常访问,例如大规模压力测试等。合作方的异常访问行为,经评估会影响 API 正常工作或关键指标,在通知该合作方后,华风爱科有权临时停用该合作方的接口账号。
禁止以任何形式缓存定位数据。
不允许使用任何妨碍或影响华风爱科缓存数据的调用方式。(正常的,按照说明文档进行的调用,是不会影响缓存的,但有一些特殊技术是可以阻止或者影响缓存正常运行的,比如传递特定的 header 信息等。)
使用经纬度定位时,提交的 latitude 和 longitude 必须四舍五入至 3 位小数,比如 q=39.921,116.469 是正确的,而不能传 q=39.9212,116.4691。
Accept-Encoding: gzip,deflate 即可启用;法律法规要求:根据中国法律法规要求,在中国境内地区使用天气预报数据时,必须使用中国气象局发布的预报数据。
API 返回数据中,LocalSource 字段的 id 值为 7 时,代表该数据来源于中国气象局(Huafeng)。此类数据包含特定的编码字段,需要通过编码表进行解析。
"LocalSource": {
"id": 7,
"Name": "Huafeng",
"WeatherCode": "01",
"WindLevelCode": "3",
"WindDirectionCode": "3"
}编码字段说明
快速参考
所有编码表已整理在「实用资料」模块中,包括完整的天气现象编码、风向编码、风力等级编码等。请前往实用资料查看详细的编码对照表和使用说明。
遵守华风爱科对 API 调用的指南和要求。请注意,华风爱科提供的新的指南和要求,也需及时更新满足。
请特别注意:某些区域某些时次没有雷达数据时,Minutecast 接口会返回 HTTP 400 错误,请务必对这种情况做容错处理。
Response Headers Cache-Control: public Content-Encoding: gzip Content-Type: application/json; charset=utf-8 Date: Wed, 29 Aug 2012 14:55:33 GMT Expires: Thu, 30 Aug 2012 14:56:34 GMT Server: Microsoft-IIS/7.5 Server: Microsoft-IIS/7.0 Transfer-Encoding: chunked Vary: Accept-Encoding X-AspNet-Version: 4.0.30319 X-Powered-By: ASP.NET
Expires: Thu, 30 Aug 2012 14:56:34 GMT 意味着数据在此时间前均有效,建议在此时间前不再重新请求。如果您使用了定位 API 接口返回结果中的 GMTOffset 来计算当地时间,请务必检查 NextOffsetChange,即下一次的 Offset 变化时间。
这样您可预知 Offset 将在何时变化,并能够在变化后及时的获取最新的 Offset 来准确的显示当地时间。