Yahoo!奇摩知識+ API 方法列表

目前發現 BBAuth 做認證時無法取得 Cookie，因而連帶影響知識+ API 像是發表、取得使用者資料無法順利使用，我們已經著手處理此問題，造成您的不便敬請見諒。

API 中需驗證的方法

所有與使用者私人資料有關的都需要使用 BBAuth 做驗證，請參考此篇文章：使用 BBAuth 驗證取得私密資料

API 存取路徑格式：

http://tw.knowledge.yahooapis.com/v1/[API 方法名稱]/[所需的參數]

API 的輸出格式：

知識+ API 提供兩種輸出格式：XML 與 JSON，可使用 format 參數來指定回傳的格式（例如：format=json），或在發出 Request 時，指定 header 為 application/xml 或 application/json。另外在使用 json 回傳時，可加上 callback 的參數做跨網域的資料交換。

API 方法列表：

AuthBootUp：啟動 AppID
QACK/question：取得問題內容
QACK/answer：列出問題的相關答案
QACK/comment：列出問題的意見
QACK/article：列出問題的評論
SEARCH：搜尋知識
DIR：分類知識列表
CATEGORY：列出指定分類 ID 中的所有分類
PROFILE/detail：個人知識檔案
PROFILE/Tracing/TAG：列出使用者的追蹤標籤
PROFILE/record/point：列出該使用者的知識點數(需要 authentication)
PROFILE/Tracing/tagging：列出使用者追蹤標籤的相關問題
PROFILE/record/answer：列出問題的評論
PROFILE/record/point：列出該使用者的知識點數（需要 authentication）
QACK/question/Create：發問問題(需要 authentication)
QACK/answer/Create：回答(需要 authentication)
QACK/comment/Create：發問評論(需要 authentication)
QACK/article/Create：發問意見(需要 authentication)
QACK/tracing/Create：新增追蹤問題(需要 authentication)

AuthBootUp 啟動 AppID

範例 Request : http://tw.knowledge.yahooapis.com/v1/AuthBootUp?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--

欄位名稱	是否必填	預設值	說明
appid	是

QACK/question 取得問題內容

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/question/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&

欄位名稱	是否必填	預設值	說明
appid	是
qid	是		問題的 ID

QACK/answer 列出問題的相關答案

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/answer/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&

欄位名稱	是否必填	預設值	說明
appid	是
qid	是		問題的 ID

QACK/comment 列出問題的意見

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/comment/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&

欄位名稱	是否必填	預設值	說明
appid	是
qid	是		問題的 ID

QACK/article 列出問題的評論

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/article/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&

欄位名稱	是否必填	預設值	說明
appid	是
qid	是		問題的 ID

SEARCH 搜尋知識

範例 Request : http://tw.knowledge.yahooapis.com/v1/SEARCH?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&p=ipod&kf=CD&intl=tw&

欄位名稱	是否必填	預設值	說明
appid	是
p	是		關鍵字
scope	否	content	搜尋範圍[content(全文)/subject(題目)/nick(發問者暱稱)]
tab	否	0	知識型態[0(不拘)/1(發問中)/2(投票中)/3(已解決)/4(評論)]
mc	否		指定分類
asktime	否		發問時間[""(任何時間)/7(一週內)/8(一個月內)/9(三個月內)/10(六個月內)/11(一年內)]
prate	否		正面評價[""(不拘)/6(80%以上)/7(60%以上)/8(40%以上)/9(20%以上)]
cp	否		頁數
kf	否		排除
intl	否		國別，目前支援 tw 與 hk
catid	否		依分類搜尋

DIR/listing 分類知識列表

範例 Request : http://tw.knowledge.yahooapis.com/v1/DIR/listing?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&kf=CD&intl=tw&catid=396540185

欄位名稱	是否必填	預設值	說明
appid	是
scope	否	content	搜尋範圍[content(全文)/subject(題目)/nick(發問者暱稱)]
tab	否	0	知識型態[0(不拘)/1(發問中)/2(投票中)/3(已解決)/4(評論)]
mc	否		指定分類
asktime	否		發問時間[""(任何時間)/7(一週內)/8(一個月內)/9(三個月內)/10(六個月內)/11(一年內)]
prate	否		正面評價[""(不拘)/6(80%以上)/7(60%以上)/8(40%以上)/9(20%以上)]
cp	否		頁數
kf	否		排除
intl	否		國別，目前支援 tw 與 hk
catid	否		依分類搜尋

CATEGORY 列出指定分類 ID 中的所有分類

範例 Request : http://tw.knowledge.yahooapis.com/v1/CATEGORY?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--

欄位名稱	是否必填	預設值	說明
appid	是

PROFILE/detail 個人知識檔案

範例 Request : http://tw.knowledge.yahooapis.com/v1/PROFILE/detail/AA00517292?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&

欄位名稱	是否必填	預設值	說明
appid	是
kid	是		使用者 ID

PROFILE/Tracing/TAG 列出使用者的追蹤標籤

範例 Request : http://tw.knowledge.yahooapis.com/v1/PROFILE/Tracing/TAG/AA00517292?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&

欄位名稱	是否必填	預設值	說明
appid	是
kid	是		使用者 ID

PROFILE/record/point 列出該使用者的知識點數(需要 authentication)

範例 Request : http://tw.knowledge.yahooapis.com/v1/PROFILE/record/point?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&

欄位名稱	是否必填	預設值	說明
appid	是
WSSID	是		用來作 Authorization 驗證的 ID

PROFILE/Tracing/tagging 列出使用者追蹤標籤的相關問題

範例 Request : http://tw.knowledge.yahooapis.com/v1/PROFILE/Tracing/tagging/AA00517292?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&tag=隨身碟病毒

欄位名稱	是否必填	說明
appid	是
kid	是	使用者 ID
tag	是	標籤

PROFILE/record/answer 列出問題的評論

範例 Request : http://tw.knowledge.yahooapis.com/v1/PROFILE/record/answer/AA00517292?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&status=all

欄位名稱	是否必填	預設值	說明
appid	是
kid	是		使用者 ID
cp	否		目前頁數
status	否	all	問題狀態[all(綜合)/new(發問中)/vote(投票中)/solved(已解決)/remove(已移除)]

PROFILE/record/point 列出該使用者的知識點數（需要 authentication）

範例 Request : http://tw.knowledge.yahooapis.com/v1/PROFILE/record/point/AA00517292?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）

欄位名稱	是否必填	說明
appid	是
kid	是	使用者 ID
WSSID	是	用來作 Authorization 驗證的 ID

QACK/question/Create 發問問題(需要 authentication)

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/question/Create?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）

欄位名稱	是否必填	預設值	說明
appid	是
subject	是		題目
content	是		內容
category	是		分類
points	是		點數
days	否	3	天數
anonymous	否	0	匿名發問[0(不暱名)/1(暱名)]
notify	否	0	提醒 [0(提醒)/1(不提醒)]

QACK/answer/Create 回答(需要 authentication)

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/answer/Create/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）

欄位名稱	是否必填	說明
appid	是
qid	是	題目
content	是	內容
reference	是	參考資料

QACK/comment/Create 發問評論(需要 authentication)

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/comment/Create/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）

欄位名稱	是否必填	說明
appid	是
qid	是	題目
content	是	內容

QACK/article/Create 發問意見(需要 authentication)

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/article/Create/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）

欄位名稱	是否必填	預設值	說明
appid	是
qid	是		問題的 ID
content	是		內容
category	是		分類
points	是		點數
notify	否	0	提醒 [0(提醒)/1(不提醒)]

QACK/tracing/Create 新增追蹤問題(需要 authentication)

範例 Request : http://tw.knowledge.yahooapis.com/v1/QACK/tracing/Create/1008043008208?appid=Fbn2UILIkYoPqtaNTG6aFYgkHY9piA2A8A--&（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）