Yahoo!奇摩生活+ API (Beta V0.1, 即將停用) 方法列表

即將停用

v0.1版即將停用，請改用V0.3版。新的版本的輸入參數以及輸出格式與舊版大部份相容，開發者僅需作少許修改便可將先前的應用程式轉換至新的API平台。

API 中需驗證的方法

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

API 存取路徑格式：

http://tw.lifestyle.yahooapis.com/v0.1/[API 方法名稱]/[所需的參數]

API 的輸出格式：

生活+ API 目前以 XML 作為回傳格式。

API 的輸出格式：

驗證 AppID
搜尋商家
取得資料
列出商家的評價意見
列出指定分類 ID 中的所有分類，若無指定，則預設為根分類
列出涵蓋範圍內某一分類下的商家 (限定 10 個)，範圍表示指定一點座標及半徑 Name
列出商家排行榜
列出使用者的評價意見，可限定商家
列出使用者的 bookmark
列出該 bookmark 下的所有商家

API 的方法列表：

Auth.bootUp：驗證 AppID

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Auth.bootUp?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U

欄位名稱	是否必填	預設值	說明
appid	是		ID of the biz

Biz.search：搜尋商家

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Biz.search?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&BizName=京兆尹&address=&page=1

欄位名稱	是否必填	預設值	說明
appid	是
BizName	是		商家名稱
address	否		指定地址
page	否	1	指定頁數

Biz.getDetails：取得資料

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Biz.getDetails?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&ID=76cbb18ff81ecdc1

欄位名稱	是否必填	預設值	說明
appid	是
ID	是		ID of the biz

Biz.listReviews：列出商家的評價意見

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Biz.listReviews?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&ID=76cbb18ff81ecdc1&begin=2&limit=100

欄位名稱	是否必填	預設值	說明
appid	是
ID	否		ID of the biz
begin	否	1	index of beginning（第幾筆開始）
limit	否	10	count limit（限定幾筆）

Class.listClasses：列出指定分類 ID 中的所有分類，若無指定，則預設為根分類

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Class.listClasses?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&id=0

欄位名稱	是否必填	預設值	說明
appid	是
id	否	0	ID of the class (Space ID)

Class.listBizsInRange：列出涵蓋範圍內某一分類下的商家 (限定 10 個)，範圍表示指定一點座標及半徑 Name

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Class.listBizsInRange?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&lon=121.54803000000000&lat=25.03660800000000&class=152959611

欄位名稱	是否必填	說明
appid	是
lon	否	ID of the class (Space ID，預設 0，表示根分類)
lat	否	longitude (經度，預設 121.5438)
class	否	latitude (緯度，預設 25.0417)

Biz.listBuzzBizs：列出商家排行榜

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Biz.listBuzzBizs?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U

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

User.listReviews：列出使用者的評價意見，可限定商家

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/User.listReviews?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&biz=76cbb18ff81ecdc1&WSSID=（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）

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

User.listBookmarks：列出使用者的 bookmark

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/User.listBookmarks?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&WSSID=（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）

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

Bookmark.listBizs：列出該 bookmark 下的所有商家

範例 Request : http://tw.lifestyle.yahooapis.com/v0.1/Bookmark.listBizs?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&ID=1&WSSID=（還需要將 Cookie 放到 Header 中，直接連是看不到資料的）