編輯“百度知道開放平臺/響應(yīng)數(shù)據(jù)包規(guī)范”

{{百度知道開放平臺導(dǎo)航}}
響應(yīng)數(shù)據(jù)包的格式由調(diào)用時傳遞的format參數(shù)指定（默認為[[xml]]格式），無論是xml格式還是[[json]]格式，輸出內(nèi)容都是[[UTF-8]]格式。目前，[[百度知道]]頻道目前支持xml、json格式。
==XML輸出格式==
*文檔編碼格式UTF-8
*接口的返回數(shù)據(jù)中，數(shù)組對應(yīng)的xml節(jié)點包含list=”true”屬性，其子節(jié)點的[[標(biāo)簽]]名跟對應(yīng)的數(shù)據(jù)有聯(lián)系，并且同個數(shù)組內(nèi)的同級節(jié)點的標(biāo)簽名一致。例如表示問題標(biāo)題列表對應(yīng)的xml輸出可能為：
<pre>
<questionList list="true">
<title><![CDATA[北京一共有幾個區(qū)？]]></title>
<title><![CDATA[百度大廈的地址是什么？]]></title>
</questionList>
</pre>
*接口的返回數(shù)據(jù)中，對象類型和普通數(shù)據(jù)類型數(shù)據(jù)（string，int，double，bool）對應(yīng)的xml節(jié)點不包含list屬性或者list屬性值為false，節(jié)點標(biāo)簽名具有實際意義，與數(shù)據(jù)所描述的信息相符。例如，表示問題的數(shù)據(jù)對應(yīng)的xml輸出為：
<pre>
<question list=”false”>
<title><![CDATA[百度大廈的地址是什么？]]></title>
<url><![CDATA[http://zhidao.xxx.com/question/b231e997ade585b3e99481e59bbd7a62310200]]</url>
<content><![CDATA[如題，百度大廈地址在]]</ content >
</question>
</pre>

==json輸出格式==
[[API]]調(diào)用時如果傳遞format參數(shù)為json（大小寫不敏感），則正常響應(yīng)包符合如下規(guī)范的json字符串：
*http響應(yīng)頭中的Content-Type指定為application/json, charset=utf-8
*字符串編碼格式是UTF-8
字符串內(nèi)容是XML輸出數(shù)據(jù)所對應(yīng)的[[PHP]]數(shù)組的標(biāo)準(zhǔn)JSON字符串

==錯誤響應(yīng)輸出格式==
錯誤響應(yīng)輸出內(nèi)容符合以下規(guī)范：
*返回內(nèi)容由error_code, error_msg, request_args這3個屬性組成，分別用于描述錯誤碼，錯誤信息，以及調(diào)用Open API時所傳遞的所有參數(shù)的信息。
*request_args屬性是一個數(shù)組，由n個包含key和value屬性的對象組成

例如，假設(shè)第三方應(yīng)用調(diào)用baidu.zhidao.getQuestionList接口時傳遞的參數(shù)api_key無效，則其對應(yīng)的xml格式的錯誤響應(yīng)包為如下格式：
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<baidu_zhidao_getQuestionList_response>
<error_code>101</error_code>
<error_msg>Invalid API key</error_msg>
<request_args list="true">
<arg>
<key><![CDATA[cid]]></key>
<value><![CDATA[249]]></value>
</arg>
<arg>
<key><![CDATA[method]]></key>
<value><![CDATA[baidu.zhidao.getQuestionLis]]></value>
</arg>
</request_args>
</ baidu_zhidao_getQuestionList_response >
</pre>
Json格式的字符串內(nèi)容是XML輸出數(shù)據(jù)所對應(yīng)的PHP數(shù)組的標(biāo)準(zhǔn)JSON字符串




==參考來源==
*http://wenku.baidu.com/view/b3f872620b1c59eef8c7b4d2.html

{{百度知道開放平臺使用手冊}}

[[category:百度知道開放平臺|Y]]