百度服务中心

API接口-订阅接口-必读规范

百度知道一旦通过您应用的订阅申请，将会实时地将您订阅的消息推送给您提供的接口。

当百度知道向您的接口提交数据时，您可以提供您所需要的安全校验方式，目前支持两种：

方式一：静态安全参数，可以指定必须携带的固定参数，参数可以为多个；
【举例】
假设给您的所有提交都需要携带key和token参数，您可以给我们提供这样的字符串：
key=xxxxx&token=xxxx，这样我们的所有请求都会携带这两个参数了。

方式二：动态安全参数，如果您的安全参数不是固定的，那么需要您提供相应的生成函数（使用php语言实现），该函数名固定为buildSecurity，输入固定为本次请求的POST字段列表（数组形式），输出为需要携带的安全参数。

【举例】
某网站需要根据key和qid、title、create_time一起生成一个sign字段，于是他们需要提供这个函数给我们：
function buildSecurity($data) {
    $key   = ‘xxxxxxxxxxx’;
    $qid   = isset($data[‘questionid’]) ? $data[‘questionid’] : ‘’;
    $title = isset($data[‘title’]) ? $data[‘title’] : ‘’;
    $ctime = isset($data[‘create_time’]) ? $data[‘create_time’] : ‘’;
    
    $sign = md5(“$qid$title$ctime$key\”);
    return “sign=$sign”;
}
我们在请求时，会获取这个函数的返回并携带到提交请求里。

所有接口涉及的字符，均使用UTF8编码。提交均采用POST方式。

百度知道回调的所有接口，不论成功与否，请务必返回json格式，且包含的字段必须如下所示：
{
   “errno”:0,                //操作是否成功，0成功，非0不成功
   “errmsg”:”success”,     //操作结果描述，如果中文，请使用utf8编码
}

如果回调返回的http code为200，且errno字段存在（不论是否为0），则认为本次交互已经成功，操作结束。

否则认为回调失败，会一直重试直至成功。