开发前必读
常用的 front-matter
开发者规范
开发者进行开放平台开发时,除了需要满足每个接口的调用频次限制、接口规范限制之外,还需注意用户敏感数据的使用规范。
接口权限说明
樊登读书开放平台对开发者的权限进行了接口级别精确控制
调用地址说明
- 测试环境http://gw1-ex-test.dushu365.com/{path}(通过商务同学获取测试环境参数)
- 正式环境https://gw1-ex.dushu365.com/{path} (仅在申请上线成功后,才能被调用成功)
接口测试号申请
出于安全性考虑,只有开发者对应的接口权限被开通,该接口才能被调用成功。开通包含 appId, appSecret 参数
全局返回码说明
开发者每次调用接口时,可能会获得正确或错误的返回码,开发者可以通过错误返回来调试排查错误。
| 返回码 | 说明 |
|---|---|
| 0000 | 成功 |
| 0001 | 无效的用户 token |
| 200001 | 参数缺失 |
| 200002 | 权限不足 |
| 200003 | 非法的请求 ip |
| 200004 | 过期的请求 |
| 200005 | 非法的签名 |
| 200006 | 无效的认证 |
| 9999 | 系统异常 |