百度知道OPEN API接口规范文档V1.0
系统名称 | 百度知道OPEN API服务接口 |
项目负责人 | |
作者 | 耿艳坤 |
文档提交日期 | 2010-08-26 |
百度在线网络技术(北京)有限公司
(版权所有,翻版必究)
修改记录
No | 修改后 版本号 | 修改内容简介 | 修改日期 | 修改人 |
1 | 1.0 | 百度知道OPEN API服务接口 | 2010-08-26 | 耿艳坤 |
1背景
本文旨在为第三方合作站点应用访问百度知道开放服务提供统一的HTTP接口调用与交互规范。
本文中描述的规范包括百度知道问题列表查询接口、检索查询接口、提问接口和回答接口。
2规范适用对象说明
本规范仅适用于由服务器端发起调用请求、POST提交数据以及GET请求文本数据结果的Open API。
3名词解释
●百度知道:zhidao.baidu
●API KEY:注册API合作时由百度的OPEN API平台分配的唯一标识一个应用的字符串,又称应用公钥
●API SECRET:注册API合作时由百度的OPEN API平台分配的应用密钥,用于平台与合作站点之间通信时的参数签名
4请求数据包格式规范
4.1URL
按照百度Open API规范,百度知道OPEN API提供如下REST风格的HTTP接口:
open.zhidao.baidu/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方式。
4.2参数
4.2.1系统级参数
以下参数是由百度Open API平台系统定义的,百度知道需要支持这些参数以便接入该平台提供开放接口。百度知道采用应用授权认证接口方式,合作初始百度知道代第三方站点申请应用分配api_key和参数签名密钥api_secret。
表格 41 API系统级参数
参数名 | 类型 | 是否必需 | 描述 |
api_key | string | 是 百度api接口 | 注册应用时分配到的api key |
method | string | 是 | 采取baidu.zhidao.getQuestionList这样的命名空间方式制定方法名 |
call_id | uint | 是 | 时间戳,系统时间的秒值,同个应用的不同api请求的time值应该是递增的, 用于防replay攻击 |
format | string | 否 | 响应包格式,可以是xml(默认)或json |
ie | string | 否 | API调用请求包的编码类型,支持UTF-8和GBK |
bd_sig | string | 是 | 参数签名,对bd_sig外所有参数串的签名,包括业务级的参数。 |
4.2.2业务级参数的通用约定
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论