SOSO問問開放API說明文檔v014

1、SOSO問問開放API 說明文檔 v0.14時間：2011-12-01注意：文檔中所有參數(shù)請在使用時均小寫調(diào)用IP請向文檔編寫人申請申請appkey頁面:/z/ApplyApp.htm開放平臺會對每個第三方應(yīng)用進(jìn)行調(diào)用接口頻率限制, 一分鐘超過限制會禁止調(diào)用支持的編碼是UTF-8，具體參見本文檔尾部中附件“ HYPERLINK l _件編 編碼”描述1. 名詞解釋questionid: 問問審核通過之后的問題ID。maskqid: 調(diào)用提問接口提交成功之后審核之前系統(tǒng)分配的ID, 和questionid(審核通過后分配的問題正式ID)有區(qū)別. 本文檔中所有關(guān)于這兩參數(shù)的說明一致。2. API請

2、求示例說明注：所有API調(diào)用帶上，appkey作認(rèn)證鑒權(quán)用，api請求參數(shù)（不同API有不同的附加參數(shù)），例： HYPERLINK http:/xxx.xxx.xxx.xxx/z/openapi/ask?appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1300353849468&sign=22de9afb7edccdf5c7645631582c4d9b /z/openapi/ask?appkey=92e2734c05a7140ac061299742041000&format=json&u

3、serid=19958784×tamp=1300353849468&sign=9d0db74ab1cb8aae7c7367ca9a55fbcd參數(shù)說明：appkey:公鑰，你申請的appkey， 以標(biāo)識來源。secretkey: 密鑰（私鑰），放在url請求參數(shù)串的最后，然后做md5算法。format: http請求數(shù)據(jù)的格式，支持xml，jsonuserid: 調(diào)用者qq號timestamp：時間戳(毫秒級)。時間戳在系統(tǒng)當(dāng)前時間前5分鐘內(nèi)認(rèn)為是有效請求。sign： 作為請求url中的最后（放到url的最后，其他參數(shù)可以無序）一個參數(shù)，做權(quán)限認(rèn)證用，是md5算法產(chǎn)生的結(jié)果值。md5

4、算法描述如下：例如本例的url請求串為：appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1300353849468），第三方分配到的密鑰secretkey(比如:d2a0ea1620de244c3e4427982bf36a34)。然后將這兩部分組裝成（直接將兩個字符串連接在一起）如下字符串a(chǎn)ppkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1300353849468d2a0ea1620

5、de244c3e4427982bf36a34然后對這個組裝后的字符串做MD5算法，即md5(appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1300353849468d2a0ea1620de244c3e4427982bf36a34)最后將md5產(chǎn)生的結(jié)果賦值給sign。注意此處僅僅是說明示例，md5中的參數(shù)不完整，md5中的參數(shù)應(yīng)該包含接口中的全部“Url參數(shù)”項。3. 問問開放平臺API接口3.1提問接口使用說明參數(shù)包含兩部分，一部分為url參數(shù)，另一部分為post包體參數(shù)接口名稱提問

6、接口URL/z/openapi/ask格式提交的數(shù)據(jù)的格式，支持json或xml，由format參數(shù)指定，該格式的數(shù)據(jù)不是url參數(shù)的一部分，而是以post 的包體方式（reques body方式）提交的數(shù)據(jù), 即是post包體參數(shù)的格式。HTTP請求方式Post是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z

7、/openapi/ask?appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1300353849468&sign=22de9afb7edccdf5c7645631582c4d9bappkey必須，公鑰，需要想問問開放平臺申請并開通format必須，post 包體（以request body方式提交數(shù)據(jù)）的數(shù)據(jù)格式，支持json或xml。注意，需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口

8、url中的format參數(shù)來確定是json或者xml）。userid可以不填，提問者的qq號碼，默認(rèn)使用app申請的時候填寫的官方提問qq號。timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明Post包體參數(shù)使用說明post 的包體方式（reques body方式）提交的數(shù)據(jù)， 需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口ur

9、l參數(shù)中的format參數(shù)來確定是json或者xml）。json格式示例（只是樣例，具體參數(shù)下見下面描述）title:這是標(biāo)題，能通過么！,anonymous:false,needautocategory:truetitle必須，問題標(biāo)題（符合問問提問規(guī)則），中文及特殊字符需要轉(zhuǎn)義, utf8編碼，否則提交的數(shù)據(jù)可能是亂碼content非必須，問題正文, 中文及特殊字符需要轉(zhuǎn)義, utf8編碼，否則提交的數(shù)據(jù)可能是亂碼anonymous必須，是否匿名 true:falseneedautocategory必須，是否讓問問自動分類 true:falsecategoryid非必須，提問指定分類idb

10、roadcast非必須，是否緊急 true:falseneedserverassp2pteams非必須，是否需要服務(wù)器來指定求助的團(tuán)隊 true:false。如果p2puserids參數(shù)已經(jīng)存在，則本參數(shù)無效p2pteamsnumneed非必須，需要求助的團(tuán)隊的個數(shù)p2puserids非必須，求助的個人或團(tuán)隊列表，求助個人或者團(tuán)隊之間以：隔開，個人數(shù)據(jù)為qq號，團(tuán)隊數(shù)據(jù)以T開頭+團(tuán)隊id返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是jsonsuccess:true,code:0,message:提問提交成功，正在審核,maskqid:1001110110 說明：success：回答是否提交成功，true或fa

11、lsecode:狀態(tài)碼，0代表成功，非0請參見message返回值message：回答結(jié)果消息maskqid：問題ID（審核未通過之前的ID）注：官方號匿名的匿名提問、回答并不影響第三方logo及站點名稱的顯示3.2回答接口使用說明參數(shù)包含兩部分，一部分為url參數(shù)，另一部分為post包體參數(shù)接口名稱回答接口URL/z/openapi/answer格式提交的數(shù)據(jù)的格式，支持json或xml，由format參數(shù)指定，該格式的數(shù)據(jù)不是url參數(shù)的一部分，而是以post 的包體方式（reques body方式）提交的數(shù)據(jù), 即是post包體參數(shù)的格式。HTTP請求方式Post是否需要權(quán)限認(rèn)證是，請參

12、見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/answer?appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1300413999750&sign=1871a202e070fdf75a8a456a44daa60

13、9 appkey必須，公鑰，需要想問問開放平臺申請并開通format必須，post 包體（以request body方式提交數(shù)據(jù)）的數(shù)據(jù)格式，支持json或xml。注意，需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url中的format參數(shù)來確定是json或者xml）。userid可以不填, 默認(rèn)使用app申請的時候填寫的官方回答qq號. 注意: 使用官方回答qq號可以對同一問題多次匿名回答timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的

14、請求時間已經(jīng)超過5分鐘”的錯誤。sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明Post包體參數(shù)使用說明post 的包體方式（reques body方式）提交的數(shù)據(jù)， 需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url參數(shù)中的format參數(shù)來確定是json或者xml）。json格式示例（只是樣例，具體參數(shù)下見下面描述）questionid:635172,content:3333333322,anonymous:truequestionid必須，問題id

15、，questionid和maskqid二選一maskqid必須，問題ID（審核未通過之前的ID）, 提問接口的返回值，此參數(shù)和questionid是互斥的，當(dāng)同時存在時只有questionid有效。content必須，回答內(nèi)容, 中文及特殊字符需要轉(zhuǎn)義, utf8編碼，否則提交的數(shù)據(jù)可能是亂碼anonymous必須，是否匿名回答 true:false返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是jsonsuccess:true,code:0,message:答案已提交，審核通過后顯示, questionid:1001110110說明：success：回答是否提交成功code:狀態(tài)碼0代表成功，非0請參見mes

16、sage返回值message：回答結(jié)果消息questionid：問題ID（該回答的問題ID，即審核通過后真實的問題ID）注：官方號匿名的匿名提問、回答并不影響第三方logo及站點名稱的顯示3.3補(bǔ)充提問接口使用說明參數(shù)包含兩部分，一部分為url參數(shù)，另一部分為post包體參數(shù)接口名稱補(bǔ)充提問接口URL/z/openapi/asksupplement格式提交的數(shù)據(jù)的格式，支持json或xml，由format參數(shù)指定，該格式的數(shù)據(jù)不是url參數(shù)的一部分，而是以post 的包體方式（reques body方式）提交的數(shù)據(jù), 即是post包體參數(shù)的格式。HTTP請求方式Post是否需要權(quán)限認(rèn)證是，請參

17、見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/asksupplement?appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1313565268299&sign=a60b43304d1a4b8595d6f91e

18、d031a976appkey必須，公鑰，需要想問問開放平臺申請并開通format必須，post 包體（以request body方式提交數(shù)據(jù)）的數(shù)據(jù)格式，支持json或xml。注意，需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url中的format參數(shù)來確定是json或者xml）。userid必須，官方提問QQ號或用戶QQ號timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。sign必須，參見 HYPERLIN

19、K l _API請求示例說明 API請求示例說明Post包體參數(shù)使用說明post 的包體方式（reques body方式）提交的數(shù)據(jù)， 需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url參數(shù)中的format參數(shù)來確定是json或者xml）。json格式示例（只是樣例，具體參數(shù)下見下面描述）questionid:2049403,content:justifiedssflquestionid必須，選擇補(bǔ)充的問題id，提問的問題Id返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是jsonsuccess:true,

20、code:0,message:提問補(bǔ)充已提交，審核通過后顯示說明：success：提交是否成功message：結(jié)果消息3.4追問接口使用說明參數(shù)包含兩部分，一部分為url參數(shù)，另一部分為post包體參數(shù)接口名稱追問對回答進(jìn)行追問接口URL/z/openapi/followask格式提交的數(shù)據(jù)的格式，支持json或xml，由format參數(shù)指定，該格式的數(shù)據(jù)不是url參數(shù)的一部分，而是以post 的包體方式（reques body方式）提交的數(shù)據(jù), 即是post包體參數(shù)的格式。HTTP請求方式Post是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中

21、的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/followask?appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1300413999750&sign=1871a202e070fdf75a8a456a44daa609 appkey必須，公鑰，需要想問問開放平臺申請并開通forma

22、t必須，post 包體（以request body方式提交數(shù)據(jù)）的數(shù)據(jù)格式，支持json或xml。注意，需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url中的format參數(shù)來確定是json或者xml）。userid必須，官方提問QQ號或用戶QQ號timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明Post包體參數(shù)使用說明pos

23、t 的包體方式（reques body方式）提交的數(shù)據(jù)， 需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url參數(shù)中的format參數(shù)來確定是json或者xml）。json格式示例（只是樣例，具體參數(shù)下見下面描述）questionid:2048202,replyid:5343002,content:2222222222questionid必須，問題idreployid必須，回答id，對回答進(jìn)行追問content必須，追問的內(nèi)容返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是jsonsuccess:true,c

24、ode:0,message:追問提交成功，正在審核說明：success：回答是否提交成功message：結(jié)果消息3.5補(bǔ)充回答接口使用說明參數(shù)包含兩部分，一部分為url參數(shù)，另一部分為post包體參數(shù)接口名稱補(bǔ)充回答接口URL/z/openapi/answersupplement格式提交的數(shù)據(jù)的格式，支持json或xml，由format參數(shù)指定，該格式的數(shù)據(jù)不是url參數(shù)的一部分，而是以post 的包體方式（reques body方式）提交的數(shù)據(jù), 即是post包體參數(shù)的格式。HTTP請求方式Post是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明

25、中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/answersupplement?appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1313486463327&sign=9ade753b467c10ecc1237221629adef4appkey必須，公鑰，需要想問問開放平臺申請并

26、開通format必須，post 包體（以request body方式提交數(shù)據(jù)）的數(shù)據(jù)格式，支持json或xml。注意，需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url中的format參數(shù)來確定是json或者xml）。userid必須，官方回答QQ號或用戶QQ號timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明Post包體參數(shù)

27、使用說明post 的包體方式（reques body方式）提交的數(shù)據(jù)， 需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url參數(shù)中的format參數(shù)來確定是json或者xml）。json格式示例（只是樣例，具體參數(shù)下見下面描述）questionid:2048036,replyid:5341034,content:55555554444questionid必須，問題idreployid必須，回答idcontent必須，回答內(nèi)容返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是jsonsuccess:true,co

28、de:0,message:補(bǔ)充回答提交成功，正在審核說明：success：補(bǔ)充回答是否提交成功message：結(jié)果消息3.6采納接口使用說明參數(shù)包含兩部分，一部分為url參數(shù)，另一部分為post包體參數(shù)接口名稱采納接口URL/z/openapi/select格式提交的數(shù)據(jù)的格式，支持json或xml，由format參數(shù)指定，該格式的數(shù)據(jù)不是url參數(shù)的一部分，而是以post 的包體方式（reques body方式）提交的數(shù)據(jù), 即是post包體參數(shù)的格式。HTTP請求方式Post是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意m

29、d5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/select?appkey=92e2734c05a7140ac061299742041000&format=json&userid=19958784×tamp=1313486750088&sign=7e9ad0ffccfb439503c85df684ec04baappkey必須，公鑰，需要想問問開放平臺申請并開通format必須，post 包體（以r

30、equest body方式提交數(shù)據(jù)）的數(shù)據(jù)格式，支持json或xml。注意，需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url中的format參數(shù)來確定是json或者xml）。userid必須，提問人的id，也即問題的所屬者（注意，不是回答的所屬者），因為只有提問者本人才能采納該提問的回答作為最終的答案timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。sign必須，參見 HYPERLINK l _API請求示

31、例說明 API請求示例說明Post包體參數(shù)使用說明post 的包體方式（reques body方式）提交的數(shù)據(jù)， 需要將Content-type設(shè)置為application/json;charset=utf8（ 其中application/json需要根據(jù)您的接口url參數(shù)中的format參數(shù)來確定是json或者xml）。json格式示例（只是樣例，具體參數(shù)下見下面描述）questionid:2031117,answerid1:5322003questionid必須，問題iduserid必須，提問人的id，也即問題的所屬者（注意，不是回答的所屬者），因為只有提問者本人才能采納該提問的回答作為最

32、終的答案answerid1必須，將要采納的回答id1answerid2非必須，將要采納的回答id2, 如果只采納一個的話, 可以不填返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是jsonsuccess:true,code:0,message:成功說明：success：操作是否提交成功message：結(jié)果消息3.7獲取用戶信息接口名稱獲取用戶信息接口URL/z/openapi/get格式返回格式是XMLHTTP請求方式Get是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _A

33、PI請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/get?appkey=92e2734c05a7140ac061299742041000&uid=19958784×tamp=1313486262946&orig=2009&type=2&id=256&sign=12ae3f38431056d38142836c439d7453appkey必須，公鑰，需要想問問開放平臺申請并開通uid必須，用戶QQ號timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致

34、，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。id必須，固定值為256type必須，固定值為2orig必須，固定值為2009sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是XML19958784/sun流沙24819142301800024221599falsefalsefalsefalsetruetruefalse說明：id：用戶的Idname：用戶的用戶名socre：用戶的積分值experience：用戶的經(jīng)驗值nextLevelExperience：下一個等級的經(jīng)驗值askQuestionNum：該用戶的提問數(shù)an

35、swerQuestionNum：該用戶的回答數(shù)level：該用戶的經(jīng)驗值等級isExpert：是否是專家isEditor：是否是前臺管理員isTop：用戶聲望是否是top100isFresh：是否是新用戶exist：是否存在該用戶canP2pAsk：是否接收一對一提問isFreeQuQuotaExhausted：是否能回答問題3.8獲取問題信息接口名稱獲取問題信息接口URL/z/openapi/get格式返回格式是XMLHTTP請求方式Get是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)

36、”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/get?appkey=92e2734c05a7140ac061299742041000×tamp=1313487427484&type=2&id=298&orig=51&qid=2027006&sign=1dbc1b7e379da700ac23a5d4feb1879fappkey必須，公鑰，需要想問問開放平臺申請并開通qid必須，問題idtimestamp必須，當(dāng)前時間，精確到毫秒，請將

37、系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。id必須，固定值為298type必須，固定值為2orig必須，固定值為51sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是XML 322314445 在拍拍里面： 對不起，發(fā)布商品失敗，錯誤:0 x2a9 你好，現(xiàn)在被編輯的商品屬性不完整，請重新編輯后再上架。1095041024拍拍4317392581雪地里的蝸牛10falsetrue2011-09-26 16:59:263 1329420355 379181509 上帝無條件愛 你要問你的發(fā)數(shù)據(jù)

38、包的朋友，我也碰到過，他有可能是直接從淘寶網(wǎng)導(dǎo)出來的數(shù)據(jù)包，要從拍拍里導(dǎo)出來的才有用。祝你生意興隆。 2011-09-25 15:05:07 false 384857 海翔心里咨詢 1329006188 781238787 懶人 換個瀏覽器發(fā)布商品，以前遇到過這樣，換個瀏覽器就好了，你試試看。 2011-09-24 23:33:28 false 說明：Question屬性id：問題idtitle：問題標(biāo)題content：問題內(nèi)容categoryId：問題所屬分類idcategoryName：問題所屬分類名稱state：問題狀態(tài)類型：4已解決問題 1待解決問題。authorId：提問者idaut

39、horName：提問者昵稱offerScore：懸賞分?jǐn)?shù)isAnonymous：是否匿名isBroadcast：是否廣播time：提問時間、解決時間、回答時間answerNum：回答數(shù)bestAnswer屬性id： 最佳回答idauthorId：回答者IdauthorName：回答者昵稱content：回答內(nèi)容time：回答時間isAnonymous：是否匿名authorTeamId：團(tuán)隊回答者idauthorTeamName：團(tuán)隊回答者昵稱commonAnswer屬性id：回答idauthorId：回答者IdauthorName：回答者昵稱content：回答內(nèi)容time：回答時間isAno

40、nymous：是否匿名3.9獲取問題ID接口名稱獲取問題ID根據(jù)提問時返回的maskqid獲取問題ID接口URL/z/openapi/get格式返回格式是XMLHTTP請求方式Get是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/get?appkey=92e2734c05a7140ac0612

41、99742041000×tamp=1313487427484&type=2&id=300&orig=51&maskqid=2027006&sign=1dbc1b7e379da700ac23a5d4feb1879fappkey必須，公鑰，需要想問問開放平臺申請并開通maskqid必須，maskqid是審核未通過之前的ID，問題審核通過之后對應(yīng)的為questionidtimestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。id必須，固定值為300type必須，固定值為2orig必須，固定值為51sign必須，參見

42、 HYPERLINK l _API請求示例說明 API請求示例說明返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是XML202700600說明：id：表示questionid，僅當(dāng)code為0時才存在該值，其他的狀態(tài)id為空。code：表示操作結(jié)果，0表示完成，-1表示錯誤。status：表示question的狀態(tài):0表示正在審核中，1表示審核成功，-1表示審核失敗。message：用來說明code的狀態(tài)。3.10獲取某分類下某種狀態(tài)的問題列表接口名稱獲取某分類下某種狀態(tài)的問題列表接口URL/z/openapi/get格式返回格式是XMLHTTP請求方式Get是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l

43、_API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/get?appkey=92e2734c05a7140ac061299742041000×tamp=1313567737050&type=2&id=268&ctg=1090584576&state=1&size=3&index=0&sign=79facf1394abfbd3eb13cd71

44、646cfb9eappkey必須，公鑰，需要想問問開放平臺申請并開通timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。id必須，固定值為268type必須，固定值為2state必須，問題狀態(tài)類型：4已解決問題 1待解決問題size必須，搜索結(jié)果問題條數(shù)（即：每頁數(shù)據(jù)的條數(shù)），每頁不能大于20條index必須，頁碼索引, 從0開始, 每一頁的大小是sizectg必須，分類id，第三方應(yīng)用只允許查詢自己已申請的分類問題列表sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明返回值（響應(yīng)

45、）響應(yīng)數(shù)據(jù)的格式是XML144204944883892256張娜提問提問提問1090584576搜搜問問12011-08-11 10:50:220falsefalse02048056717300751開s!嬞了問問如何提問？1090584576搜搜問問12011-06-13 16:58:221falsefalse0說明：totalNum表示返回的滿足條件的總記錄數(shù)Question屬性id：問題idauthorId：提問者idauthorName：提問者昵稱title：問題標(biāo)題categoryId：問題所屬分類idcategoryName：問題所屬分類名稱state：問題狀態(tài)類型：4已解決問題

46、1待解決問題。time：提問時間、解決時間、回答時間answerNum：回答數(shù)isAnonymous：是否匿名isBroadcast：是否廣播offerScore：懸賞分?jǐn)?shù)3.11獲取某分類下搜索關(guān)鍵字信息接口名稱獲取某分類下搜索關(guān)鍵字信息即根據(jù)關(guān)鍵字在某分類下查找指定類型的問題列表接口URL/z/openapi/get格式返回格式是XMLHTTP請求方式Get是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是

47、說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/get?appkey=92e2734c05a7140ac061299742041000×tamp=1313487519886&type=2&id=263&orig=101&state=1&word=%E9%A2%9C%E8%89%B2&size=4&index=0&ct=3&ctg=1090519040&mark=em&sign=73c5058c582bc7aa0ad63344b9593ac8appkey必須，公鑰，需要想問問開放平臺申請并開通timestamp必須，

48、當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。id必須，固定值為263type必須，固定值為2orig必須，固定值為101word必須，搜索詞, 中文字符使用UTF-8編碼，否則無法提交成功state必須，問題狀態(tài)類型：4已解決問題 1待解決問題 103 精華知識size必須，搜索結(jié)果問題條數(shù)（即：每頁數(shù)據(jù)的條數(shù)），每頁不能大于20條index必須，頁碼索引, 從0開始, 每一頁的大小是sizect必須，摘要長度ctg必須，分類id，第三方應(yīng)用只允許查詢自己已申請的分類問題列表mark必須，指定用什么標(biāo)記標(biāo)紅（例如可用em）sign

49、必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是XML提問110111003135262661179943749深藍(lán)飄帶為什么要提問?12011-08-16 13:38601090584576搜搜問問1090584576搜搜問問說明：該結(jié)果中的排序是按照結(jié)果跟搜索的關(guān)鍵字的相關(guān)性來排序的，相關(guān)性越高排序越靠前。word：表示搜索關(guān)鍵字size：表示每頁顯示的記錄數(shù)index：表示當(dāng)前的頁碼totalNum：表示返回的滿足條件的總記錄數(shù)ss：搜索特色內(nèi)容： 0：所有內(nèi)容； 1：回答（提問）帶圖片； 2：專家回答。sti：搜索時間間隔。 0

50、:全部時間； 1：一天內(nèi)；2：三天內(nèi)； 3：一周內(nèi)； 4：一月內(nèi)。Question屬性id：問題idauthorId：提問者idauthorName：提問者昵稱title：問題標(biāo)題content：問題內(nèi)容state：問題狀態(tài)類型：4已解決問題 1待解決問題。time：提問時間、解決時間、回答時間answerNum：回答數(shù)offerScore：懸賞分?jǐn)?shù)categoryId：問題所屬分類idcategoryName：問題所屬分類名稱recommendCategory屬性categoryId：推薦分類idcategoryName：推薦分類名稱3.12獲取用戶某種狀態(tài)的問題列表接口名稱獲取用戶某種狀態(tài)

51、的問題列表接口URL/z/openapi/get格式返回格式是XMLHTTP請求方式Get是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/get?appkey=be5d857c3949db77c351315903719000×tamp=1318232544177&type=2&id=

52、266&state=1&size=5&index=0&uid=19958784&sign=7e20f60628590a2493b4984d56c49f61appkey必須，公鑰，需要想問問開放平臺申請并開通timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。id必須，固定值為266type必須，固定值為2uid必須，查詢的用戶qq號state必須，問題狀態(tài)類型：4已解決問題 1待解決問題size必須，搜索結(jié)果問題條數(shù)（即：每頁數(shù)據(jù)的條數(shù)），每頁不能大于20條index必須，頁碼索引, 從0開始, 每一頁的大小是si

53、zesign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是XML 4 319948896 19958784 /sun流沙 騰訊微博現(xiàn)在有多少用戶? test 3 2011-09-28 18:22:26 0 false 385941504 外語 313503869 19958784 /sun流沙 中秋節(jié)是啥時候呢? 3 2011-08-31 12:05:15 3 false 385941504 外語 說明：totalNum表示返回的滿足條件的總記錄數(shù)Question屬性id：問題idauthorId：提問者idauthorName：提問

54、者昵稱title：問題標(biāo)題state：問題狀態(tài)類型：4已解決問題 1待解決問題。time：提問時間、解決時間、回答時間answerNum：回答數(shù)isAnonymous：是否匿名3.13獲取某分類下的精華知識接口名稱獲取某分類下精華知識接口URL/z/openapi/get格式返回格式是XMLHTTP請求方式Get是否需要權(quán)限認(rèn)證是，請參見 HYPERLINK l _API請求示例說明 API請求示例說明 中的md5算法，注意md5時請包含此接口中的所有“Url參數(shù)”（“ HYPERLINK l _API請求示例說明 API請求示例說明”中僅僅是說明示例，參數(shù)并不完整）Url參數(shù)（url中包含的

55、參數(shù)）使用說明（此為示例URL，不可直接使用）/z/openapi/get?appkey=92e2734c05a7140ac061299742041000×tamp=1313567737050&type=2&id=268&ctg=1090584576&state=1&size=3&index=0&sign=79facf1394abfbd3eb13cd71646cfb9eappkey必須，公鑰，需要想問問開放平臺申請并開通timestamp必須，當(dāng)前時間，精確到毫秒，請將系統(tǒng)的時鐘跟標(biāo)準(zhǔn)時間保持一致，否則將出現(xiàn)“您發(fā)送的請求時間已經(jīng)超過5分鐘”的錯誤。id必須，固定值為270type必

56、須，固定值為2state必須，固定值為1num必須，搜索結(jié)果問題條數(shù)（即：每頁數(shù)據(jù)的條數(shù)），每頁不能大于20條index必須，頁碼索引, 從0開始, 每一頁的大小是sizectg必須，分類id，第三方應(yīng)用只允許查詢自己已申請的分類問題列表sign必須，參見 HYPERLINK l _API請求示例說明 API請求示例說明返回值（響應(yīng)）響應(yīng)數(shù)據(jù)的格式是XML 385941504 外語 4 1000 20 299972593 寧波英語口語輔導(dǎo)班,口語培訓(xùn)班哪里好呀？ 385941504 外語 1 1 2011-06-29 10:50:37 299869541英語中的三單式是什么385941504外

57、語112011-06-28 22:39:31 說明：Category屬性categoryId：分類idcategoryName：分類名稱categoryState：分類狀態(tài)categoryNum：表示返回的滿足條件的總記錄數(shù)questionNum： 表示當(dāng)前頁中的條數(shù)Question屬性id：問題idauthorId：提問者idauthorName：提問者昵稱title：問題標(biāo)題categoryId：問題所屬分類idcategoryName：問題所屬分類名稱answerNum：回答數(shù)frequency：熱度time：提問時間、解決時間、回答時間第三方APP提供API接口SOSO問問將部分?jǐn)?shù)據(jù)主

58、動推送給第三方APP，而這需要第三方提供API接口來接收問問推送的數(shù)據(jù)，第三方的接收方式是Http post的方式，參數(shù)編碼是UTF-8格式，為了保存數(shù)據(jù)的安全性及一致性，我們將使用“API請求示例說明中”的MD5算法，用第三方的secretky(密鑰)進(jìn)行加密，第三方對之進(jìn)行有效性校驗即可。以下接口需要第三方提供并接收其中的參數(shù)4.1回答接收接口第三方調(diào)用者使用“ HYPERLINK l _3.1提問 提問”接口提交提問之后，如果問問平臺上有用戶對該提問進(jìn)行了回答，那么問問平臺會將回答推送給第三方調(diào)用者，以便及時將回答呈現(xiàn)給提問的用戶。下面是第三方需要提供的API接口規(guī)范格式和要求。需要支持

59、的POST參數(shù)如下：參數(shù)名類型描述actionString值為feedAnswerqidint問題IDmaskqIdint偽問題idanswerIdint回答idauthorIdint回答者的用戶IdauthorNameString回答者的用戶名，編碼是UTF-8titleString問題的title，編碼是UTF-8contentString回答內(nèi)容，編碼是UTF-8timeString回答時間isAnonymousString是否匿名signString簽名，算法如下：(只使用time屬性和secretkey)sign=Md5(time=1323857314d2a0ea1620de244c

60、3e4427982bf36a34)字符串最后的部分為secretkey(密鑰)第三方響應(yīng)信息格式如下:0說明：Code：錯誤號，0為成功Message：錯誤描述4.1補(bǔ)充回答接收接口第三方調(diào)用者使用“ HYPERLINK l _3.1提問 提問”接口提交提問之后，如果問問平臺上有用戶對該提問進(jìn)行了補(bǔ)充回答，那么問問平臺會將補(bǔ)充回答推送給第三方調(diào)用者，以便及時將回答呈現(xiàn)給提問的用戶。下面是第三方需要提供的API接口規(guī)范格式和要求。需要支持的POST參數(shù)如下：參數(shù)名類型描述actionString值為feedAnswerSupplementqidint問題IDmaskqIdint偽問題idansw