百度知道开 放平台openapi接口规范文档v1.0

《百度知道开 放平台openapi接口规范文档v1.0》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、百度知道开放平台OPENAPI接口规范文档V1.0系统名称百度知道开放平台OPENAPI服务接口项目负责人作者陈霖文档提交日期2010-11-04百度在线网络技术（北京）有限公司(版权所有,翻版必究)修改记录No修改后版本号修改内容简介修改日期修改人11.0百度知道OPENAPI服务接口2010-11-04陈霖目录1背景62规范适用对象说明63名词解释64请求数据包格式规范64.1URL64.2参数74.2.1系统级参数74.2.2业务级参数的通用约定74.2.3参数签名算法75响应数据包格式规范85.

2、1XML输出格式85.2json输出格式95.3错误响应输出格式96错误码定义97API接口细则107.1baidu.zhidao.getCatalogInfo107.1.1功能107.1.2参数107.1.3返回值117.2baidu.zhidao.getQuestionList117.2.1功能117.2.2参数117.2.3返回值117.3baidu.zhidao.getQuestionSearch127.3.1功能127.3.2参数127.3.3返回值127.4baidu.zhidao.getQ

3、uestionInfo137.4.1功能137.4.2参数137.4.3返回值137.5baidu.zhidao.getQuestionAnswer147.5.1功能147.5.2参数147.5.3返回值157.6baidu.zhidao.getUserInfo157.6.1功能157.6.2参数157.6.3返回值157.7baidu.zhidao.getUserQuestionList167.7.1功能167.7.2参数167.7.3返回值167.8baidu.zhidao.getUserAnswe

4、rList177.8.1功能177.8.2参数177.8.3返回值177.9baidu.zhidao.getRecommend187.9.1功能187.9.2参数187.9.3返回值187.10baidu.zhidao.getUserScoreRank197.10.1功能197.10.2参数197.10.3返回值197.11baidu.zhidao.changeUserWealth207.11.1功能207.11.2参数207.11.3返回值217.12baidu.zhidao.setBestAnswe

5、r217.12.1功能217.12.2参数217.12.3返回值217.13baidu.zhidao.question217.13.1功能217.13.2参数227.13.3返回值227.14baidu.zhidao.answer227.14.1功能227.14.2参数227.14.3返回值238第三方提供API接口细则238.1回答反馈接口238.2动作提醒接口259附件及参考资料251背景本文旨在为第三方合作站点应用访问知道频道开放服务提供统一的HTTP接口调用与交互规范。本文中描述的规范包括知道频

6、道的查询分类树信息、问题列表查询接口、检索查询接口、查询精彩推荐接口、查询用户信息接口、查询用户提问回答信息接口、查询用户排行榜接口、提问接口、回答接口、消息提醒接口、财富兑换接口和采纳最佳答案接口。2规范适用对象说明本规范仅适用于由服务器端发起调用请求、POST提交数据以及GET请求文本数据结果的OpenAPI。3名词解释l百度知道：http://zhidao.baidu.coml各网站的百度知道频道：http://zhidao.xxx.comlAPIKEY：注册API合作时由百度的OPENAPI平台

7、分配的唯一标识一个应用的字符串，又称应用公钥lAPISECRET：注册API合作时由百度的OPENAPI平台分配的应用密钥，用于平台与合作站点之间通信时的参数签名4请求数据包格式规范4.1URL按照百度OpenAPI规范，百度知道频道OPENAPI提供如下REST风格的HTTP接口：http://zhidao.xxx.com/restserver/zhidao?{query_string}query_string由系统级参数部分和具体OpenAPI调用参数部分组成，以key1=value&key2=va

8、lue2&…表示，对于采用POST请求的OpenAPI，query_string部分则是在POST请求体里。所有查询类的OpenAPI接口既支持POST，也支持GET方式，提交类的OPENAPI接口仅支持POST方式。1.1参数1.1.1系统级参数以下参数是由百度OpenAPI平台系统定义的，百度知道频道需要支持这些参数以便接入该平台提供开放接口。百度知道频道采用应用授权认证接口方式，合作初始百度知道开放平台代第三方站点申请应用分配api_