开发者文档

编程建议

1) 目前版本 为 1；

2) 没有特别说明下，所有接口，参数都是大小写不敏感的；

3) 时间的默认格式是 时间戳 ；

4) 所有接口都支持HTTPS协议，为了保证安全性暂不支持HTTP协议接口。

5) 在本地做好缓存，可以减小接口网络调用次数，加快响应时间以达到更好的用户体验；

6) 原则上，对于同一应用和用户，只需用调用一次 accessToken，然后在应用服务器或者本地保存 access_token，直到 access_token 授权过期（返回 authorization expired，详见附录-MSG 定义） ；

7) 接口参数说明中，required 字段为 N 或者 False 的参数可以不传；

8) 接口返回说明中， required 字段为 N 或者 False 的参数不一定会返回； 在未来的更新升级中，也可能会返回没有在说明中出现的字段，应用设计中要做好对应这些和说明不符的异常的兼容准备；

9) 接口返回中，我们会返回 JSON object 类型的对象，由于服务升级，或者维护需要，可能会出现文档中没有描述的返回值或者字段，或者由于服务器故障返回不是 JSON 格式的数据，在开发过程中应该注意，并且做好兼容准备；

10) 请不要使用文档中没提及或建议的返回值或者参数，这个可能是服务器的 bug，可能在未来升级中会失效；