admin 管理员组文章数量: 887042
2024年2月28日发(作者:擦车用什么毛巾好)
百度知道开放平台OPEN API接口规范文档v1.0
百度知道开放平台OPEN API接口规范文档V1.0
系统名称
项目负责人
作者
文档提交日期
百度知道开放平台OPEN API服务接口
陈霖
2010-11-04
百度在线网络技术(北京)有限公司
(版权所有,翻版必究)
百度在线网络技术(北京)有限公司 - 1 -
百度知道开放平台OPEN API接口规范文档v1.0
百度在线网络技术(北京)有限公司 - 2 -
百度知道开放平台OPEN API接口规范文档v1.0
修改记录
No
1
修改后
版本号
1.0
修改内容简介
百度知道OPEN API服务接口
修改日期
2010-11-04
修改人
陈霖
百度在线网络技术(北京)有限公司 - 3 -
百度知道开放平台OPEN API接口规范文档v1.0
目 录
1
2
3
4
背景 ......................................................................................................................................................... 6
规范适用对象说明 ................................................................................................................................. 6
名词解释 ................................................................................................................................................. 6
请求数据包格式规范 ............................................................................................................................. 6
4.1 URL ............................................................................................................................................ 6
4.2 参数 .......................................................................................................................................... 7
4.2.1 系统级参数 ..................................................................................................................... 7
4.2.2 业务级参数的通用约定 ................................................................................................. 7
4.2.3 参数签名算法 ................................................................................................................. 7
响应数据包格式规范 ............................................................................................................................. 8
5.1 XML输出格式............................................................................................................................ 8
5.2 json输出格式.......................................................................................................................... 9
5.3 错误响应输出格式 ................................................................................................................... 9
错误码定义 ........................................................................................................................................... 10
API接口细则 ........................................................................................................................................ 10
7.1 alogInfo ........................................................................................... 10
7.1.1 功能 ............................................................................................................................... 10
7.1.2 参数 ............................................................................................................................... 11
7.1.3 返回值 ........................................................................................................................... 11
7.2 stionList ......................................................................................... 11
7.2.1 功能 ............................................................................................................................... 11
7.2.2 参数 ............................................................................................................................... 11
7.2.3 返回值 ........................................................................................................................... 12
7.3 stionSearch ..................................................................................... 12
7.3.1 功能 ............................................................................................................................... 12
7.3.2 参数 ............................................................................................................................... 12
7.3.3 返回值 ........................................................................................................................... 13
7.4 stionInfo ......................................................................................... 13
7.4.1 功能 ............................................................................................................................... 13
7.4.2 参数 ............................................................................................................................... 13
7.4.3 返回值 ........................................................................................................................... 14
7.5 stionAnswer ..................................................................................... 14
7.5.1 功能 ............................................................................................................................... 14
7.5.2 参数 ............................................................................................................................... 14
7.5.3 返回值 ........................................................................................................................... 15
7.6 rInfo ................................................................................................. 15
7.6.1 功能 ............................................................................................................................... 15
7.6.2 参数 ............................................................................................................................... 15
7.6.3 返回值 ........................................................................................................................... 15
7.7 rQuestionList ................................................................................. 16
7.7.1 功能 ............................................................................................................................... 16
7.7.2 参数 ............................................................................................................................... 16
- 4 -
5
6
7
百度在线网络技术(北京)有限公司
百度知道开放平台OPEN API接口规范文档v1.0
8
9
7.7.3 返回值 ........................................................................................................................... 17
7.8 rAnswerList ..................................................................................... 17
7.8.1 功能 ............................................................................................................................... 17
7.8.2 参数 ............................................................................................................................... 17
7.8.3 返回值 ........................................................................................................................... 18
7.9 ommend ............................................................................................... 18
7.9.1 功能 ............................................................................................................................... 18
7.9.2 参数 ............................................................................................................................... 18
7.9.3 返回值 ........................................................................................................................... 19
7.10 rScoreRank ....................................................................................... 19
7.10.1 功能 ............................................................................................................................... 19
7.10.2 参数 ............................................................................................................................... 19
7.10.3 返回值 ........................................................................................................................... 20
7.11 UserWealth ....................................................................................... 20
7.11.1 功能 ............................................................................................................................... 20
7.11.2 参数 ............................................................................................................................... 20
7.11.3 返回值 ........................................................................................................................... 21
7.12 tAnswer ............................................................................................. 21
7.12.1 功能 ............................................................................................................................... 21
7.12.2 参数 ............................................................................................................................... 21
7.12.3 返回值 ........................................................................................................................... 21
7.13 on ....................................................................................................... 21
7.13.1 功能 ............................................................................................................................... 21
7.13.2 参数 ............................................................................................................................... 22
7.13.3 返回值 ........................................................................................................................... 22
7.14 ........................................................................................................... 22
7.14.1 功能 ............................................................................................................................... 22
7.14.2 参数 ............................................................................................................................... 22
7.14.3 返回值 ........................................................................................................................... 23
第三方提供API接口细则 ................................................................................................................... 23
8.1 回答反馈接口......................................................................................................................... 23
8.2 动作提醒接口......................................................................................................................... 25
附件及参考资料 ................................................................................................................................... 26
百度在线网络技术(北京)有限公司 - 5 -
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接口:
/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方式。
百度在线网络技术(北京)有限公司 - 6 -
4.2 参数
4.2.1 系统级参数
以下参数是由百度Open API平台系统定义的,百度知道频道需要支持这些参数以便接入该平台提供开放接口。百度知道频道采用应用授权认证接口方式,合作初始百度知道开放平台代第三方站点申请应用分配api_key和参数签名密钥api_secret。
表格 4-1 API系统级参数
参数名
api_key
method
类型
string
string
是否必需 描述
是
是
注册应用时分配到的api key
采取stionList这样的命名空间方式制定方法名
时间戳,系统时间的秒值,同个应用的不同api请求的time值应该是递增的, 用于防replay攻击
响应包格式,可以是xml(默认)或json
API调用请求包的编码类型,支持UTF-8和GBK
参数签名,对bd_sig外所有参数串的签名,包括业务级的参数。
call_id uint 是
format
ie
bd_sig
string
string
string
否
否
是
4.2.2 业务级参数的通用约定
百度知道频道遵守百度Open API规范中业务级通用参数的约定。
表格 4-2 业务级参数的通用约定
参数名
page_no
page_size
类型
Int
Int
描述
用于支持分页的api,默认为1,表示第几页
用于支持分页的api,表示每页返回多少条数据,默认以及上限为25
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);
百度在线网络技术(北京)有限公司 - 7 -
//按照如下格式转换数组为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
接口的返回数据中,数组对应的xml节点包含list=”true”属性,其子节点的标签名跟对应的数据有联系,并且同个数组内的同级节点的标签名一致。例如表示问题标题列表对应的xml输出可能为:
接口的返回数据中,对象类型和普通数据类型数据(string,int,double,bool)对应的xml节点不包含list属性或者list属性值为false,节点标签名具有实际意义,与数据所描述的信息相符。例如,表示问题的数据对应的xml输出为:
百度在线网络技术(北京)有限公司 - 8 -
5.2 json输出格式
API调用时如果传递format参数为json(大小写不敏感),则正常响应包符合如下规范的json字符串:
http响应头中的Content-Type指定为application/json, charset=utf-8
字符串编码格式是UTF-8
字符串内容是XML输出数据所对应的PHP数组的标准JSON字符串
5.3 错误响应输出格式
错误响应输出内容符合以下规范:
返回内容由error_code, error_msg, request_args这3个属性组成,分别用于描述错误码,错误信息,以及调用Open API时所传递的所有参数的信息。
request_args属性是一个数组,由n个包含key和value属性的对象组成
例如,假设第三方应用调用stionList接口时传递的参数api_key无效,则其对应的xml格式的错误响应包为如下格式:
baidu_zhidao_getQuestionList_response >
Json格式的字符串内容是XML输出数据所对应的PHP数组的标准JSON字符串
6 错误码定义
百度在线网络技术(北京)有限公司 - 9 -
百度开放知道OPEN API调用过程中可能会返回的错误码定义如下表所示:
error_code
0
1
2
3
4
5
100
101
103
104
105
106
200
900
12001
12002
12003
12004
error_msg
Success
Unknown error
Unsupported openapi method
Open api request limit reached
Description
成功
未知错误
Open api接口不被支持
应用对open api接口的调用请求数达到上限
参数无效或缺失
Api key无效
Call_id参数无效或已被使用过
签名无效
参数过多
参数签名算法未被平台所支持
没有权限访问数据
应用不存在
必选参数格式错误
问题生命已经结束
用户财富不足
没有权限采纳此问题
Service temporarily unavailable
后端服务暂时不可用
Unauthorized client IP address:%s
open api调用端的IP未被授权
Invalid parameter
Invalid API key
Invalid call_id parameter
Incorrect signature
Too many parameters
Unsupported signature method
No permission to access data
No such application exists
Parameters format error
operate for invalid question
User wealth is not enough
No permission to set best
7 API接口细则
以下接口返回数据均是以XML格式为demo,JSON格式的字符串内容是XML输出数据所对应的PHP数组的标准JSON字符串。
7.1 alogInfo
7.1.1 功能
获取知道频道的分类树信息
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=alogInfo &call_id=1276418994&format=xml&bd_sig=sig-result
7.1.2 参数
参数名 类型 描述
百度在线网络技术(北京)有限公司 - 10 -
4.2.1 系统级参数全体
7.1.3 返回值
Response XML 示例
Response XML 标签说明
标签名
cid
cname
topcid
描述
分类ID
分类名称
分类的父级别分类id,如果topcid =0则分类为根级别分类
7.2 stionList
7.2.1 功能
基于知道频道分类ID获取对应分类下的问题列表
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=stionList&call_id=1276418994&format=xml&bd_sig=sig-result&cid=11&qstatus=0&page_no=2&page_size=25
7.2.2 参数
参数名 类型 描述
4.2.1 系统级参数全体
4.2.2 业务级参数全体
cid
qstatus
int
int
知道频道的分类ID
问题状态 0为待解决 1为已解决
7.2.3 返回值
百度在线网络技术(北京)有限公司 - 11 -
Response XML 示例
Response XML 标签说明
标签名
id
url
title
content
cid
cname
描述
问题ID
该问题在知道频道的URL
问题标题
提问内容
该问题在知道频道所属的分类ID
该问题在知道频道所属的分类名称
7.3 stionSearch
7.3.1 功能
基于检索关键字在频道中搜索匹配的问题列表
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=stionSearch&call_id=12764994&format=xml&bd_sig=sig-result&keywords=植物大站僵尸+游戏&qstatus=0&page_no=2&page_size=25
7.3.2 参数
参数名 类型 描述
4.2.1 系统级参数全体
4.2.2 业务级参数全体
keywords
qstatus
string
int
检索关键字 多个检索关键字之间使用+号连接
问题状态 0为待解决 1为已解决
7.3.3 返回值
Response XML 示例
百度在线网络技术(北京)有限公司 - 12 -
Response XML 标签说明
标签名
id
url
title
content
cid
cname
summary
描述
问题ID
该问题在知道频道的URL
问题标题
提问内容
该问题在知道频道所属的分类ID
该问题在知道频道所属的分类名称
已解决问题的最佳答案摘要,待解决问题无此字段
7.4 stionInfo
7.4.1 功能
基于频道问题ID获取对应问题的数据以及回答
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=stionInfo&call_id=127323494&format=xml&bd_sig=sig-result&qid=54a9e997ade585b3e99481e59bbd7a62310900
7.4.2 参数
参数名
qid
类型
string
描述
知道频道的问题ID
4.2.1 系统级参数全体
7.4.3 返回值
Response XML 示例
百度在线网络技术(北京)有限公司 - 13 -
Response XML 标签说明
标签名
questionInfo
answerCount
bestAnswers
answers
content
cite
描述
问题内容数据,具体明细参考7.1和7.2
问题包含回答数量
最佳答案列表
普通答案列表
回答内容
回答参考资料
7.5 stionAnswer
7.5.1 功能
基于知道频道问题ID、回答ID获取对应问题的数据的回答
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=stionInfo&call_id=127323494&format=xml&bd_sig=sig-result&qid=54a9e997ade585b3e99481e59bbd7a62310900&aid=54a9e997ade585b3e99481e59bbd7a62310900
7.5.2 参数
参数名
qid
aid
类型
string
string
描述
知道频道的问题ID
知道频道的回答ID
4.2.1 系统级参数全体
百度在线网络技术(北京)有限公司 - 14 -
7.5.3 返回值
Response XML 示例
Response XML 标签说明
标签名
questionInfo
answerInfo
描述
问题内容数据,具体明细参考7.1和7.2
回答内容数据
7.6 rInfo
7.6.1 功能
基于频道用户的utype、uid和uname获取用户积分等详细信息
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=rInfo&call_id=127323494&format=xml&bd_sig=sig-result&utype= baidu&uid=0&uname=username
7.6.2 参数
参数名
utype
uid
uname
类型
string
int
string
描述
频道使用的用户系统类型
在频道登陆过的用户id(自有用户系统必填)
在频道登陆过的用户名(百度用户系统必填)
4.2.1 系统级参数全体
7.6.3 返回值
Response XML 示例
百度在线网络技术(北京)有限公司 - 15 -
Response XML 标签说明
标签名
personUrl
score
wealth
qcount
account
bestrate
level
userTitle
isExpert
expertLevel
expertTitle
描述
用户名片页地址
用户经验值
用户财富值
提问条数
回答条数
被采纳为最佳的比例
用户在知道频道的级别
用户在知道频道的头衔
用户是否为专家用户,0不是,1是
专家用户专家级别
专家用户专家头衔
7.7 rQuestionList
7.7.1 功能
基于频道用户的utype、uid和uname获取用户的提问列表信息
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=rQuestionList&call_id=1276418994&format=xml&bd_sig=sig-result&cid=249&qstatus=0&page_no=2&page_size=25&utype=baidu&uname=coolaxis&uid=0
7.7.2 参数
参数名 类型 描述
4.2.1 系统级参数全体
4.2.2 业务级参数全体
utype
uid
string
int
频道使用的用户系统类型
在频道登陆过的用户id(自有用户系统必填)
百度在线网络技术(北京)有限公司 - 16 -
uname string 在频道登陆过的用户名(百度用户系统必填)
7.7.3 返回值
Response XML 示例
Response XML 标签说明
标签名
id
url
title
cid
qstatus
cname
createTime
描述
问题ID
该问题在知道频道的URL
问题标题
该问题在知道频道所属的分类ID
问题状态0为待解决,1为已解决,2为已关闭
该问题在知道频道所属的分类名称
问题创建时间(unix时间戳形式)
7.8 rAnswerList
7.8.1 功能
基于频道用户的utype、uid和uname获取用户的回答问题列表信息
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=rAnswerList&call_id=1276418994&format=xml&bd_sig=sig-result&cid=249&qstatus=0&page_no=2&page_size=25&utype=baidu&uname=coolaxis&uid=0
7.8.2 参数
参数名 类型 描述
4.2.1 系统级参数全体
4.2.2 业务级参数全体
utype string 频道使用的用户系统类型
百度在线网络技术(北京)有限公司 - 17 -
uid
uname
int
string
在频道登陆过的用户id(自有用户系统必填)
在频道登陆过的用户名(百度用户系统必填)
7.8.3 返回值
Response XML 示例
Response XML 标签说明
标签名
id
url
title
cid
qstatus
cname
createTime
描述
问题ID
该问题在知道频道的URL
问题标题
该问题在知道频道所属的分类ID
问题状态0为待解决,1为已解决,2为已关闭
该问题在知道频道所属的分类名称
问题创建时间(unix时间戳形式)
7.9 ommend
7.9.1 功能
获取知道频道的精彩推荐信息
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=ommend &call_id=127323494&format=xml&bd_sig=sig-result
7.9.2 参数
参数名 类型 描述
4.2.1 系统级参数全体
7.9.3 返回值
百度在线网络技术(北京)有限公司 - 18 -
Response XML 示例
Response XML 标签说明
标签名
picUrl
picLink
title
url
cname
catUrl
描述
精彩推荐图片推荐图片地址
精彩图片链接地址
精彩推荐文字推荐标题
文字链接地址
精彩推荐文字推荐分类名称
精彩推荐文字推荐分类链接地址
7.10 rScoreRank
7.10.1 功能
获取知道频道的用户积分排行信息
URL Demo:
/restserver/zhidao?api_key=1uMqYWpHo3MoLH&method=rScoreRank&call_id=127323494&format=xml&bd_sig=sig-result&type=0&limit=2
7.10.2 参数
参数名
type
limit
类型
int
int
描述
积分榜单类型,0为总积分榜,1为上周上升最快积分榜
获取前N条排行数据,最多为100条
4.2.1 系统级参数全体
7.10.3 返回值
百度在线网络技术(北京)有限公司 - 19 -
Response XML 示例
Response XML 标签说明
标签名
rank
utype
personUrl
uname
level
userTitle
score
描述
用户总积分/上升积分排名
用户系统类型,例如baidu、renren、wanmei
用户名片页地址
用户昵称
用户级别
用户头衔
总积分/上升积分
7.11 UserWealth
7.11.1 功能
基于频道用户的utype、uid和uname对用户的财富进行操作
URL Demo:
/restserver/zhidao参数全部为POST方式
7.11.2 参数
参数名
utype
uid
uname
wealth
类型
string
int
string
int
描述
频道使用的用户系统类型
在频道登陆过的用户id(自有用户系统必填)
在频道登陆过的用户名(百度用户系统必填)
增加或者减少的财富值(正数为增加财富,负数为扣除财富)
4.2.1 系统级参数全体
百度在线网络技术(北京)有限公司 - 20 -
7.11.3 返回值
Response XML 示例
7.12 tAnswer
7.12.1 功能
为自己的提问选择最佳答案
URL Demo:
/restserver/zhidao 参数全部为POST方式
7.12.2 参数
参数名
qid
aid
thankWords
utype
uid
uname
类型
string
string
string
string
int
string
描述
POST字段问题qid
POST字段回答id
POST字段感谢语
POST字段频道使用的用户系统类型
POST字段在频道登陆过的用户id(自有用户系统必填)
POST字段在频道登陆过的用户名(百度用户系统必填)
4.2.1 系统级参数全体api_key method call_id format bd_sig(POST)
7.12.3 返回值
Response XML 示例
7.13 on
7.13.1 功能
向知道频道进行提问
URL Demo:
/restserver/zhidao 参数全部为POST方式
百度在线网络技术(北京)有限公司 - 21 -
7.13.2 参数
参数名
title
content
cid
pic_url
utype
uid
uname
类型
string
string
int
string
string
int
string
描述
POST字段问题标题
POST字段问题内容
POST字段分类id
POST字段贴图地址
POST字段频道使用的用户系统类型
POST字段在频道登陆过的用户id(自有用户系统必填)
POST字段在频道登陆过的用户名(百度用户系统必填)
4.2.1 系统级参数全体api_key method call_id format bd_sig(POST)
7.13.3 返回值
Response XML 示例
Response XML 标签说明
标签名
error_code
error_msg
qid
描述
错误号,0为成功
错误描述
问题ID
7.14
7.14.1 功能
向知道频道的待解决问题进行回答
URL Demo:
/restserver/zhidao 参数全部为POST方式
7.14.2 参数
参数名
qid
content
pic_url
类型
string
string
string
描述
POST字段提供回答的问题ID
POST字段回答内容
POST字段贴图地址
4.2.1 系统级参数全体api_key method call_id format bd_sig (POST)
百度在线网络技术(北京)有限公司 - 22 -
cite
utype
uid
uname
string
string
int
string
POST字段回答参考资料
POST字段频道使用的用户系统类型
POST字段在频道登陆过的用户id(自有用户系统必填)
POST字段在频道登陆过的用户名(百度用户系统必填)
7.14.3 返回值
Response XML 示例
Response XML 标签说明
标签名
error_code
error_msg
描述
错误号,0为成功
错误描述
8 第三方提供API接口细则
知道频道需要将部分数据主动反馈给第三方,而这就需要第三方提供API接口来保证接收知道频道反馈的数据。如果第三方需要接受这些数据,则需要提供一个统一的REST风格的HTTP接口,所有接口参数都以POST方式传递。第三方接口接收的参数和输出都统一使用UTF-8编码。同时,为了保证数据一致性,知道平台在每次发送反馈请求的同时都会所有参数进行签名,具体签名加密算法和4.2.3章节描述的算法一致,使用第三方的密钥进行加密,第三方对之进行有效性校验即可。
8.1 回答反馈接口
使用提问API(on)的第三方,其用户使用该API提交提问之后,如果知道平台上有用户对该提问进行了回答,那么是需要一种机制反馈给第三方API调用者,以便及时将回答反馈给提问的用户,解决用户的疑问。本节描述提问下产生回答后,第三方需要提供的API接口规范格式和要求。需要支持的POST参数如下:
参数名
method
qid
aid
utype
uid
uname
类型
string
string
string
string
int
string
描述
值为ck
问题ID
回答ID
提问用户的用户类型,例如baidu、renren、飞信
提问用户的uid(百度账号此项为0)
提问用户的用户名
百度在线网络技术(北京)有限公司 - 23 -
bd_sig
string 参数签名
第三方基于接收到的qid和aid向平台发起请求,调用stionAnswer API接口获取对应提问下的回答信息。
第三方合作站点如果不采用消息提醒=》抓取回答内容的方式,可以选择下面这个直接接收回答数据的方法,需要支持的POST参数如下:
参数名
method
qid
aid
utype
uid
uname
content
pic_url
cite
bd_sig
类型
string
string
string
string
int
string
string
string
string
string
描述
值为swer
问题ID
回答ID
提问用户的用户类型,例如baidu、renren、wanmei
第三方账号系统uid(百度账号此项为0)
提问用户的用户名
回答内容
贴图地址
回答参考资料
参数签名
第三方合作接收到平台的回答反馈后,需要按指定数据格式输出数据信息,输出数据格式为UTF-8编码的XML接口。具体数据格式为:
Response XML 示例
ck接口返回:
swer接口返回:
Response XML 标签说明
标签名
error_code
error_msg
描述
错误号,0为成功
错误描述
百度在线网络技术(北京)有限公司 - 24 -
上述两种POST HTTP接口,对于使用提问API的第三方,实现一种即可,应用注册申请时指明具体采用策略即可。
8.2 动作提醒接口
当用户在知道频道进行回答和采纳最佳答案操作的时候,系统会自动输出一个消息对用户进行提醒,为了方便第三方可以及时的对用户进行提醒,需要第三方开发按照以下接口规范开发消息提醒接口。需要支持的POST参数如下:
参数名
method
msgType
qid
aid
utype
uid
uname
bg_sig
类型
string
int
string
string
string
int
string
string
描述
值为g
消息类型,1为提问有新回答,2为答案被采纳为最佳答案
提问ID
回答ID
需要提醒用户的用户类型,例如baidu、renren、wanmei
需要提醒用户uid(百度账号此项为0)
需要提醒用户的用户名
参数签名
第三方合作接收到平台的回答反馈后,需要按指定数据格式输出数据信息,输出数据格式为UTF-8编码的XML接口。具体数据格式为:
Response XML 示例
g接口返回:
Response XML 标签说明
标签名
error_code
error_msg
描述
错误号,0为成功
错误描述
9 附件及参考资料
百度在线网络技术(北京)有限公司 - 25 -
版权声明:本文标题:知道开放平台openAPI接口规范文档 V1.0 内容由网友自发贡献,该文观点仅代表作者本人, 转载请联系作者并注明出处:http://www.freenas.com.cn/jishu/1709075055h537708.html, 本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,一经查实,本站将立刻删除。
发表评论