WIKI使用導(dǎo)航
站長(zhǎng)百科導(dǎo)航
站長(zhǎng)專題
- 網(wǎng)站推廣
- 網(wǎng)站程序
- 網(wǎng)站賺錢
- 虛擬主機(jī)
- cPanel
- 網(wǎng)址導(dǎo)航專題
- 云計(jì)算
- 微博營(yíng)銷
- 虛擬主機(jī)管理系統(tǒng)
- 開(kāi)放平臺(tái)
- WIKI程序與應(yīng)用
- 美國(guó)十大主機(jī)
百度知道開(kāi)放平臺(tái)/響應(yīng)數(shù)據(jù)包規(guī)范
來(lái)自站長(zhǎng)百科
響應(yīng)數(shù)據(jù)包的格式由調(diào)用時(shí)傳遞的format參數(shù)指定(默認(rèn)為xml格式),無(wú)論是xml格式還是json格式,輸出內(nèi)容都是UTF-8格式。目前,百度知道頻道目前支持xml、json格式。
XML輸出格式[ ]
- 文檔編碼格式UTF-8
- 接口的返回?cái)?shù)據(jù)中,數(shù)組對(duì)應(yīng)的xml節(jié)點(diǎn)包含list=”true”屬性,其子節(jié)點(diǎn)的標(biāo)簽名跟對(duì)應(yīng)的數(shù)據(jù)有聯(lián)系,并且同個(gè)數(shù)組內(nèi)的同級(jí)節(jié)點(diǎn)的標(biāo)簽名一致。例如表示問(wèn)題標(biāo)題列表對(duì)應(yīng)的xml輸出可能為:
<questionList list="true"> <title><![CDATA[北京一共有幾個(gè)區(qū)?]]></title> <title><![CDATA[百度大廈的地址是什么?]]></title> </questionList>
- 接口的返回?cái)?shù)據(jù)中,對(duì)象類型和普通數(shù)據(jù)類型數(shù)據(jù)(string,int,double,bool)對(duì)應(yīng)的xml節(jié)點(diǎn)不包含list屬性或者list屬性值為false,節(jié)點(diǎn)標(biāo)簽名具有實(shí)際意義,與數(shù)據(jù)所描述的信息相符。例如,表示問(wèn)題的數(shù)據(jù)對(duì)應(yīng)的xml輸出為:
<question list=”false”> <title><![CDATA[百度大廈的地址是什么?]]></title> <url><![CDATA[http://zhidao.xxx.com/question/b231e997ade585b3e99481e59bbd7a62310200]]</url> <content><![CDATA[如題,百度大廈地址在]]</ content > </question>
json輸出格式[ ]
API調(diào)用時(shí)如果傳遞format參數(shù)為json(大小寫(xiě)不敏感),則正常響應(yīng)包符合如下規(guī)范的json字符串:
- http響應(yīng)頭中的Content-Type指定為application/json, charset=utf-8
- 字符串編碼格式是UTF-8
字符串內(nèi)容是XML輸出數(shù)據(jù)所對(duì)應(yīng)的PHP數(shù)組的標(biāo)準(zhǔn)JSON字符串
錯(cuò)誤響應(yīng)輸出格式[ ]
錯(cuò)誤響應(yīng)輸出內(nèi)容符合以下規(guī)范:
- 返回內(nèi)容由error_code, error_msg, request_args這3個(gè)屬性組成,分別用于描述錯(cuò)誤碼,錯(cuò)誤信息,以及調(diào)用Open API時(shí)所傳遞的所有參數(shù)的信息。
- request_args屬性是一個(gè)數(shù)組,由n個(gè)包含key和value屬性的對(duì)象組成
例如,假設(shè)第三方應(yīng)用調(diào)用baidu.zhidao.getQuestionList接口時(shí)傳遞的參數(shù)api_key無(wú)效,則其對(duì)應(yīng)的xml格式的錯(cuò)誤響應(yīng)包為如下格式:
<?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 >
Json格式的字符串內(nèi)容是XML輸出數(shù)據(jù)所對(duì)應(yīng)的PHP數(shù)組的標(biāo)準(zhǔn)JSON字符串