编辑“百度知道开放平台/第三方提供API接口细则”

{{百度知道开放平台导航}}
知道频道需要将部分数据主动反馈给第三方，而这就需要第三方提供[[API]]接口来保证接收知道频道反馈的数据。

如果第三方需要接受这些数据，则需要提供一个统一的REST风格的[[HTTP]]接口，所有接口参数都以[[POST]]方式传递。第三方接口接收的参数和输出都统一使用[[UTF-8]]编码。同时，为了保证数据一致性，知道平台在每次发送反馈请求的同时都会所有参数进行签名，使用第三方的[[密钥]]进行加密，第三方对之进行有效性校验即可。

==回答反馈接口==
使用提问API（baidu.zhidao.question）的第三方，其用户使用该API提交提问之后，如果知道平台上有用户对该提问进行了回答，那么是需要一种机制反馈给第三方API调用者，以便及时将回答反馈给提问的用户，解决用户的疑问。本节描述提问下产生回答后，第三方需要提供的API接口规范格式和要求。需要支持的POST参数如下：
[[Image:BaiduZhidao_ThirdAPI1.png|center]]

第三方基于接收到的qid和aid向平台发起请求，调用baidu.zhidao.getQuestionAnswer API接口获取对应提问下的回答信息。

第三方合作站点如果不采用消息提醒=》抓取回答内容的方式，可以选择下面这个直接接收回答数据的方法，需要支持的POST参数如下：
[[Image:BaiduZhidao_ThirdAPI2.png|center]]

第三方合作接收到平台的回答反馈后，需要按指定数据格式输出数据信息，输出数据格式为UTF-8编码的[[XML]]接口。具体数据格式为：
*'''Response XML 示例'''
baidu.zhidao.feedback接口返回:
[[Image:BaiduZhidao_ThirdAPI3.png|center]]

baidu.zhidao.feedAnswer接口返回:
[[Image:BaiduZhidao_ThirdAPI4.png|center]]

*'''Response XML 标签说明'''
[[Image:BaiduZhidao_ThirdAPI5.png|center]]

上述两种POST HTTP接口，对于使用提问API的第三方，实现一种即可，应用注册申请时指明具体采用策略即可。

==动作提醒接口==
当用户在知道频道进行回答和采纳最佳答案操作的时候，系统会自动输出一个消息对用户进行提醒，为了方便第三方可以及时的对用户进行提醒，需要第三方开发按照以下接口规范开发消息提醒接口。需要支持的POST参数如下：
[[Image:BaiduZhidao_ThirdAPI6.png|center]]

第三方合作接收到平台的回答反馈后，需要按指定数据格式输出数据信息，输出数据格式为UTF-8编码的XML接口。具体数据格式为：
*'''Response XML 示例'''
baidu.zhidao.feedMsg接口返回:
[[Image:BaiduZhidao_ThirdAPI7.png|center]] 

*'''Response XML 标签说明'''
[[Image:BaiduZhidao_ThirdAPI8.png|center]]





==参考来源==
*http://wenku.baidu.com/view/b3f872620b1c59eef8c7b4d2.html

{{百度知道开放平台使用手册}}

[[category:百度知道开放平台|D]]