Yahoo!奇摩生活+ API 方法列表 v0.3

API 存取路徑格式:

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

API 的輸出格式:

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

API 方法列表:

API 的詳細說明:

Auth.bootUp:驗證 AppID

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

欄位名稱 是否必填 預設值 說明
appid   商家的代號

Addr.listCity:列出縣市

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

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

Addr.listDistrict:列出鄉鎮市區

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Addr.listDistrict?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&city=A

欄位名稱 是否必填 預設值 說明
appid    
city   縣市代碼,可參考Addr.listCity的輸出結果中的id欄位值

Addr.listArea:列出區域(夜市/商圈)

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Addr.listArea?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&city=A&dist=02

欄位名稱 是否必填 預設值 說明
appid    
city   縣市代碼,可參考Addr.listCity的輸出結果中的id欄位值
dist   鄉鎮市區代碼,可參考Addr.listDistrict的輸出結果中的id欄位值

Biz.search:搜尋商家

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

欄位名稱 是否必填 預設值 說明
appid    
BizName   商家名稱
photo 0 是否回傳照片,內定為不回傳
address   指定地址
page 1 指定頁數

Biz.getDetails:取得資料

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

欄位名稱 是否必填 預設值 說明
appid    
ID   商家的代號

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

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Biz.listReviews?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&ID=N97K68S30418&begin=0&limit=100

欄位名稱 是否必填 預設值 說明
appid    
ID   商家的代號
begin 0 index of beginning(第幾筆開始)
limit 10 count limit(限定幾筆)
sort latest 排序方式,可以是 latest 或是 hottest

Biz.getPhotos:取得商家的照片

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Biz.getPhotos?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&ID=P87YBWS38512&begin=1&limit=100

欄位名稱 是否必填 預設值 說明
appid    
ID   商家的代號
page 1 指定頁數
pagesize 10 每頁幾筆
sort latest 排序方式,可以是 latest 或是 hottest

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

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

欄位名稱 是否必填 預設值 說明
appid    
id 0 ID of the class (Space ID,預設 0,表示根分類)

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

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Class.listBizsInRange?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&lon=121.548030&lat=25.036608&class=152979953

欄位名稱 是否必填 預設值 說明
appid    
class   ID of the class (Space ID,預設 0,表示根分類)
lon   longitude (經度)
lat   latitude (緯度)
radius 20km 範圍半徑,內定值為20公里

Search.getTopQuery:列出熱門關鍵字

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Search.getTopQuery?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U

欄位名稱 是否必填 預設值 說明
appid    
count 10 count limit(限定幾筆)

Theme.getList:列出精選主題

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Theme.getList?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U

欄位名稱 是否必填 預設值 說明
appid    
begin 1 index of beginning(第幾筆開始)
count 5 count limit(限定幾筆)

Theme.getDetail:取得精選主題詳細資料

範例 Request : http://tw.lifestyle.yahooapis.com/v0.3/Theme.getDetail?appid=ufjH6rDIkYs86zmIuaPqu4BEOIR8IshHg10U&id=30

欄位名稱 是否必填 預設值 說明
appid    
id   精選主題的id,請參考Theme.getList的傳回值id欄位

工具與實作參考

  • ASTRA

    ASTRA 是一個 ActionScript 的 RIA 工具包,有許多由 Yahoo! 所開發的 Flash 與 Flex 的元件、函式庫、工具包、控制項,方便給 ActionScript 的開發者使用。

  • 設計模式

    常用模組的互動設計模式參考,提昇您網站的可用性。

  • 效能處理

    改進網站效能的實作原則,內容包含了實驗結果與測試工具,讓您可以依據這些實作原則建立起高效能的網站。

  • 網路安全

    網路安全的實作原則與規定,讓使用者相信您所撰寫的應用程式並受到保護。

  • YUI 使用者函式庫

    YUI 提供製作 Web 2.0 網站所需的 JavaScript 相關功能與控制項,更提供了 CSS 的解決方案。除了符合前端快速開發的要求,更是一個最專業、文件最齊全的函式庫。