心知天气 API 调用示例

举例说明心知天气 API 的基本调用方法

注： 心知天气官网正式启用新域名：www.seniverse.com ，因此本项目由 thinkpage-api-demos 改名为 seniverse-api-demos

目录

• Javascript 本示例仅做开发参考使用，不建议在生产环境下暴露 key！生产环境下请通过后端进行签名验证

  • 直接调用
  • JSONP

• Node.js

  • 使用更安全的签名验证方式（荐）

• Python

  • 直接调用

    • urllib
    • requests

  • 使用更安全的签名验证方式（荐）

• PHP

  • 使用更安全的签名验证方式（荐）
  • PHP demo, contributed by open source community

• Android

  • 可直接使用已封装好的 Android SDK 注：该 SDK 已停止维护，不建议使用
  • 或自主发起 http 请求，进行 API 调用

• Ruby

• Java

• Swift4

• Object-C

• Common Lisp

  • 使用更安全的签名验证方式（荐）
  • cl-seniverse-api ( Lisp SDK )

常见问题

1. 我在本地调试的时候，如何进行域名绑定？

本地调试时，请在 我的账号 -> 我的服务 页面填写域名为：127.0.0.1。若 127.0.0.1 在本机无法访问，请注意是否开启了全局代理。

2. 为什么我绑定了 127.0.0.1 但访问时报错（没有找到域名，或者报跨域请求的错误）？（常见于纯前端 API 调用时）

请通过 127.0.0.1 的链接，通过 jsonp 的形式访问，而不是 localhost，localhost 访问会跨域

请通过 127.0.0.1 的链接，通过 jsonp 的形式访问，而不是 localhost，localhost 访问会跨域

请通过 127.0.0.1 的链接，通过 jsonp 的形式访问，而不是 localhost，localhost 访问会跨域

3. 关于 API 调用问题

为了保证您账号的安全，不建议纯前端进行 API 调用！仅仅通过前端调用会造成您的 UID 和 Key 暴露，可能会带来不必要的麻烦。推荐的调用方式有：

• 后端进行 API 调用获取数据后交给前端渲染
• 或者后端构造 JSONP 形式的请求链接，交给前端调用

4. 关于 API 调用失败的问题

可能的原因有：

• ts 时间戳过短
• Key 加密后的结果没有通过 Base64 编码
• 在构造签名的时候，参数的顺序不正确！参与签名的参数有 UNIX 时间戳ts，签名失效时间ttl（单位为秒，缺省为 1800，可选）和用户IDuid。请确保：
  1. 参数按照键字典升序排列，例如ts=1443079775&ttl=30&uid=U123456789或者ts=1443079775&uid=U123456789
  2. ts和ttl的单位都是秒
• Last but not least，请将 demo 内的 API key 等参数替换为自己账户的数据

Third party modules

• Javascript
  • seniverse-jsonp

Contributors

• weishuaigithub
• hewiez
• wuqingzheng
• flyingant
• muyinliu
• mokeyjay
• ecmadao