百度知道开放平台频道API接口规范文档(1.0.1)

百度知道开放平台OPEN API接口规范文档

V 1.0.1

系统名称百度知道开放平台OPEN API服务接口

项目负责人

作者陈霖

文档提交日期2010-11-04

百度在线网络技术（北京）有限公司

(版权所有,翻版必究)

修改记录

No 修改后

版本号

修改内容简介修改日期修改人

1 1.0 百度知道OPEN API服务接口2010-11-04 陈霖

2 1.0.1 baidu.zhidao.getQuestionInfo修改

baidu.zhidao.setBestAnswer修改

2011-02-17 王兴

目录

1背景 (6)

2规范适用对象说明 (6)

3名词解释 (6)

4请求数据包格式规范 (6)

4.1URL (6)

4.2参数 (7)

4.2.1系统级参数 (7)

4.2.2业务级参数的通用约定 (7)

4.2.3参数签名算法 (7)

5响应数据包格式规范 (8)

5.1XML输出格式 (8)

5.2json输出格式 (9)

5.3错误响应输出格式 (9)

6错误码定义 (10)

7API接口细则 (10)

7.1baidu.zhidao.getCatalogInfo (10)

7.1.1功能 (10)

7.1.2参数 (11)

7.1.3返回值 (11)

7.2baidu.zhidao.getQuestionList (11)

7.2.1功能 (11)

7.2.2参数 (11)

7.2.3返回值 (12)

7.3baidu.zhidao.getQuestionSearch (12)

7.3.1功能 (12)

7.3.2参数 (12)

7.3.3返回值 (13)

7.4baidu.zhidao.getQuestionInfo (13)

7.4.1功能 (13)

7.4.2参数 (13)

7.4.3返回值 (14)

7.5baidu.zhidao.getQuestionAnswer (15)

7.5.1功能 (15)

7.5.2参数 (15)

7.5.3返回值 (15)

7.6baidu.zhidao.getUserInfo (15)

7.6.1功能 (15)

7.6.2参数 (16)

7.6.3返回值 (16)

7.7baidu.zhidao.getUserQuestionList (16)

7.7.1功能 (16)

7.7.2参数 (17)

7.7.3返回值 (17)

7.8baidu.zhidao.getUserAnswerList (17)

7.8.1功能 (17)

7.8.2参数 (18)

7.8.3返回值 (18)

7.9baidu.zhidao.getRecommend (18)

7.9.1功能 (18)

7.9.2参数 (19)

7.9.3返回值 (19)

7.10baidu.zhidao.getUserScoreRank (19)

7.10.1功能 (19)

7.10.2参数 (20)

7.10.3返回值 (20)

7.11baidu.zhidao.changeUserWealth (20)

7.11.1功能 (20)

7.11.2参数 (21)

7.11.3返回值 (21)

7.12baidu.zhidao.setBestAnswer (21)

7.12.1功能 (21)

7.12.2参数 (21)

7.12.3返回值........................................................................................... 错误！未定义书签。

7.13baidu.zhidao.question (23)

7.13.1功能 (23)

7.13.2参数 (23)

7.13.3返回值 (23)

7.14baidu.zhidao.answer (23)

7.14.1功能 (23)

7.14.2参数 (24)

7.14.3返回值 (24)

8第三方提供API接口细则 (24)

8.1回答反馈接口 (24)

8.2动作提醒接口 (26)

9附件及参考资料 (27)

1背景

本文旨在为第三方合作站点应用访问知道频道开放服务提供统一的HTTP接口调用与交互规范。

本文中描述的规范包括知道频道的查询分类树信息、问题列表查询接口、检索查询接口、查询精彩推荐接口、查询用户信息接口、查询用户提问回答信息接口、查询用户排行榜接口、提问接口、回答接口、消息提醒接口、财富兑换接口和采纳最佳答案接口。

2规范适用对象说明

本规范仅适用于由服务器端发起调用请求、POST提交数据以及GET请求文本数据结果的Open API。

3名词解释

●百度知道：

●各网站的百度知道频道：

●API KEY：注册API合作时由百度的OPEN API平台分配的唯一标识一个应用的字符串，又

称应用公钥

●API SECRET：注册API合作时由百度的OPEN API平台分配的应用密钥，用于平台与合作站

点之间通信时的参数签名

4请求数据包格式规范

4.1URL

按照百度Open API规范，百度知道频道OPEN API提供如下REST风格的HTTP接口：

/restserver/zhidao?{query_string}

query_string由系统级参数部分和具体Open API调用参数部分组成，以key1=value&key2=value2&…表示，对于采用POST请求的Open API，query_string部分则是在POST 请求体里。所有查询类的Open API接口既支持POST，也支持GET方式，提交类的OPEN API接口仅支持POST方式。