书签百度知道开放平台openAPI接口规范文档 V10

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。百度知道开放平台OPEN API接口规范文档V1.0

百度在线网络技术(北京)有限公司

(版权所有,翻版必究)

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。修改记录

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。

目录

1 背景. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

2 规范适用对象说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

3 名词解释. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

4 请求数据包格式规范. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

4. 1 URL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

4.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

4.2. 1 系统级参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

4.2.2 业务级参数的通用约定. . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

4.2.3 参数签名算法. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

5 响应数据包格式规范. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

5. 1 XML输出格式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

5.2 json输出格式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

5.3 错误响应输出格式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

6 错误码定义. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7 API接口细则. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 1 baidu. zhidao.getCatalogInfo. . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 1. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 1.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 1.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.2 baidu. zhidao.getQuestionList. . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.2. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.2.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.2.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.3 baidu. zhidao.getQuestionSearch. . . . . . . . . . . . . . . . . . .错误未定义书签。

7.3. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。

7.3.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.3.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.4 baidu. zhidao.getQuestionInfo. . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.4. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.4.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.4.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.5 baidu. zhidao.getQuestionAnswer. . . . . . . . . . . . . . . . . . .错误未定义书签。

7.5. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.5.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.5.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.6 baidu. zhidao.getUserInfo. . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.6. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.6.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.6.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.7 baidu. zhidao.getUserQuestionList. . . . . . . . . . . . . . . . .错误未定义书签。

7. 7. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 7.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 7.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.8 baidu. zhidao.getUserAnswerList. . . . . . . . . . . . . . . . . . .错误未定义书签。

7.8. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.8.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.8.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.9 baidu. zhidao.getRecommend. . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.9. 1 功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.9.2 参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7.9.3 返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 10 baidu. zhidao.getUserScoreRank. . . . . . . . . . . . . . . . . . . .错误未定义书签。

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。

7. 10. 1功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 10.2参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 10.3返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 11 baidu. zhidao.changeUserWealth. . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 11. 1功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 11.2参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 11.3返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 12 baidu. zhidao. setBestAnswer. . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 12. 1功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 12.2参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 12.3返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 13 baidu. zhidao.question. . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 13. 1功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 13.2参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 13.3返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 14 baidu. zhidao.answer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 14. 1功能. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 14.2参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

7. 14.3返回值. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

8 第三方提供API接口细则. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

8. 1 回答反馈接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

8.2 动作提醒接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

9 附件及参考资料. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .错误未定义书签。

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。

1 背景

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

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

2 规范适用对象说明

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

3 名词解释

 百度知道:

 各网站的百度知道频道:

 API KEY:注册API合作时由百度的OPEN API平台分配的唯一标识一个应用的

字符串,又称应用公钥

 API SECRET:注册API合作时由百度的OPEN API平台分配的应用密钥,用于平

台与合作站点之间通信时的参数签名

4 请求数据包格式规范

4. 1 URL

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

{query_string}query_string 由系统级参数部分和具体Open API调用参数部分组成, 以

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。key1=value&key2=value2&…表示,对于采用POST请求的Open API, query_string部分则是在POST请求体里。所有查询类的Open API接口既支持POST,也支持GET方式,提交类的OPEN API接口仅支持POST方式。

4. 2参数

4. 2. 1系统级参数

以下参数是由百度Open API平台系统定义的, 百度知道频道需要支持这些参数以便接入该平台提供开放接口。百度知道频道采用应用授权认证接口方式,合作初始百度知道开放平台代第三方站点申请应用分配api_key和参数签名密钥api_secret。表格4-1 API系统级参数

4. 2. 2业务级参数的通用约定

百度知道频道遵守百度Open API规范中业务级通用参数的约定。

表格4-2业务级参数的通用约定

4. 2. 3参数签名算法

参数签名生成算法采取如下方式( PHP版) ,其它语言根据注释描述完成等同功能:

资料内容仅供您学习参考如有不当或者侵权请联系改正或者删除。

//param_array是key-value形式的参数数组,不包括api_secret密钥本身

//secret是合作申请成功后分配的api_secret密钥function generate_sig($param_array, $secret) {

$str =;

//对param_array中的参数名称进行升序排序ksort($param_array) ;

//按照如下格式转换数组为string格式foreach ($param_array as $k=>$v) {

$str .= "$k=$v";

}

//string末端补充api_secret密钥

$str .= $secret;

//生成32位小写MD5为最终的数据签名return md5($str) ;

}

注:密钥是百度知道频道分配给第三方应用的secret_key, 该算法返回的结果便是系统级参数中的bd_sig。

5 响应数据包格式规范

响应数据包的格式由调用时传递的format参数指定(默认为xml格式) ,无论是xml格式还是json格式,输出内容都是UTF-8格式。当前, 百度知道频道当前支持xml、json格式。

5. 1 XML输出格式

 文档编码格式UTF-8