無名小站 API

blogService/{guid|wid}/articles

功能說明 (Detail)

取得指定的網誌的文章列表.

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/blogService/{guid|wid}/articles

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
start	否	正整數	從第幾筆開始抓取	1	1
count	否	正整數	回傳筆數，預設 20 筆，最多 20 筆	20	20

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/blogService/6GEBDOA3NFVOOXL5TZVBDGNZNI/articles?start=1&count=10
或
http://wretch.yahooapis.com/v1.2/blogService/openapi01/articles?start=1&count=10

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
article_id	是	正整數	文章編號	無	32331733
post_time	是	日期	文章發表日期 (年-月-日時:分)	無	2011-01-06 02:22
title	是	字串	文章標題	無	下午茶 (二)
author	是	字串	文章作者的無名帳號	無	openapi01
status	是	指定字串	保護方式: Public(公開), Private(隱藏), Password_Protected(通關密碼), Friends_Only(好友保護)	無	Private
url	是	網址	文章網址	無	http://www.wretch.cc/blog/openapi01/32331733
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <articles xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="0" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <article yahoo:uri="http://www.wretch.cc/blog/openapi01"> <article_id>32331733</article_id> <post_time>2011-01-06 02:22</post_time> <title><[CDATA[下午茶 (二)]]></title> <author>openapi01</author> <status>Private</status> <url>http://www.wretch.cc/blog/openapi01/32331733</url> <lang>zh-Hant-TW</lang> </article> <article yahoo:uri="http://www.wretch.cc/blog/openapi01"> <article_id>31259913</article_id> <post_time>2011-01-01 22:22</post_time> <title><[CDATA[下午茶]]></title> <author>openapi01</author> <status>Public</status> <url>http://www.wretch.cc/blog/openapi01/31259913</url> <lang>zh-Hant-TW</lang> </article> </articles>

blogService/{guid|wid}/articles (POST)

功能說明 (Detail)

在指定的網誌發表新文章.

只有版主和共筆作者能發表文章.

不提供分享最新動態到 Yahoo 奇摩或 Facebook 的功能.

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/blogService/{guid|wid}/articles

通訊方式 (HTTP Method)

POST

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01

以下參數必須以 "XML的格式" 帶在 "Content" 中

參數名稱	是否必填	參數型態	說明	預設值	範例
title	是	字串	文章標題	無	下午茶 (二)
text	是	字串	文章內容	無	內容II內容II內容II
site_category_id	否	正整數	全站分類. 如果未填寫或指定的分類不存在, 則使用系統建議分類	系統自動決定	229
user_category_id	否	正整數	個人分類	0	12
status	否	指定字串	保護方式: Public(公開), Private(隱藏), Password_Protected(通關密碼), Friends_Only(好友保護)	Public	Private
key	否	字串	通關密碼. 只有在保護方式是 Password_Protected 的時候此參數才有意義, 至少五個字數,且需同時包含英文字母與數字	無	25th-April
key_note	否	字串	通關密碼提示	無	我的生日
friend_group	否	正整數	好友保護的群組編號. 只有在保護方式是 Friend_only 的時候此參數才有意義. 預設是開放給所有好友. 當共筆作者在發表文章時, 這個欄位仍然是使用板主的好友群組編號.	0	0
allow_comment	否	指定字串	回應權限: wide_open, Members_Only, Friends_Only, No_one	wide_open	No_one
trackback_url	否	字串	引用通知	無
set_cover	否	指定字串	設為置頂文章: true, false	false	false
post_time	否	日期字串	調整發文時間 (年-月-日時:分)	現在時間	2011-01-06 02:22

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/blogService/6GEBDOA3NFVOOXL5TZVBDGNZNI/articles
or
http://wretch.yahooapis.com/v1.2/blogService/openapi01/articles

POST 協定中的參數:

<?xml version="1.0" encoding="UTF-8"?>
<req>
  <title>我是標題</title>
  <text><[CDATA[我是內容內容內容內容內容]]></content>
  <url></url>
</req>

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
article_id	是	正整數	文章編號	無	32331733
url	是	網址	文章網址	無
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <article xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="0" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <article_id>32331733</article_id> <lang>zh-Hant-TW</lang> </article>

blogService/{guid|wid}/article/{article_id}

功能說明 (Detail)

取得指定的文章.

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/blogService/{guid|wid}/article/{article_id}

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
article_id	是	正整數	文章編號	無	31259913

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/blogService/6GEBDOA3NFVOOXL5TZVBDGNZNI/article/31259913
or
http://wretch.yahooapis.com/v1.2/blogService/openapi01/article/31259913

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
url	是	網址	文章網址	無	http://www.wretch.cc/blog/openapi01/32331733
blog_name	字串	是	網誌名稱	無	my blog
title	是	字串	文章標題	無	下午茶 (二)
author	是	字串	文章作者的無名帳號	無	openapi01
post_time	是	日期字串	發文時間 (年-月-日時:分)	無	2011-01-06 02:22
text_abstract	是	字串	文章內容預覽	無	內容II內容II內容II
text	是	字串	文章內容	無	內容II內容II內容II
site_category_id	是	正整數	全站分類編號	無	226
site_category_name	是	字串	全站分類	無	心情小語
user_category_id	是	正整數	個人分類編號	0	12
user_category_name	是	字串	個人分類	無	閒聊
status	是	指定字串	保護方式: Public(公開), Private(隱藏), Password_Protected(通關密碼), Friends_Only(好友保護)	Public	Private
allow_comment	是	指定字串	回應權限: Wide_open(完全開放回應), Members_Only(僅開放會員回應), Friends_Only(僅開放好友回應), No_one(不允許回應)	wide_open	No_one
today_counter	是	正整數	當日人氣	0	0
total_counter	是	正整數	累積人氣	0	0
total_recommend	是	正整數	推薦次數	0	0
total_comment	是	正整數	回應次數	0	0
total_trackback	是	正整數	引用次數	0	0
total_collection	是	正整數	有多少人收藏了這篇文章	0	0
img	否	網址	文章內的第一個圖片網址	無
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <article xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/blog/openapi01"> <url>http://www.wretch.cc/blog/openapi01/32331733</url> <blog_name>my blog</blog_name> <title><[CDATA[下午茶 (二)]]></title> <post_time>2011-01-06 02:22</post_time> <text_abstract><[CDATA[內容II內容II內容II]]></text_abstract> <text><[CDATA[內容II內容II內容II]]></text> <site_category_id>226</site_category_id> <site_category_name>心情小語</site_category_name> <user_category_id>12</user_category_id> <user_category_name>閒聊</user_category_name> <status>Private</status> <allow_comment>No_one</allow_comment> <today_counter>0</today_counter> <total_counter>0</total_counter> <total_recommend>0</total_recommend> <total_trackback></total_trackback> <total_collection></total_collection> <img></img> <lang>zh-Hant-TW</lang> </article>

albumService/{guid|wid}/albums

功能說明 (Detail)

取得指定的使用者的相簿列表. 回應的內容會依照訪客的身分而有所不同.

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/albumService/{guid|wid}/albums

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
start	否	正整數	從第幾筆開始抓取	1	1
count	否	正整數	回傳筆數，預設 20 張相片，最多 20 張	20	20

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/albumService/6GEBDOA3NFVOOXL5TZVBDGNZNI/albums?start=1&count=10
or
http://wretch.yahooapis.com/v1.2/albumService/openapi01/albums?start=1&count=10

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
book_id	是	正整數	相簿編號	無	2
status	是	字串	相簿保護方式： Public (完全開放), Private (完全隱藏), Password_Protected (通關密碼), Friends_only (好友保護)	無	Public
title	是	字串	相簿主題	無	openapi test 2
cover	否	網址	封面照片的網址，如果此相簿沒有設定封面相片則傳回空字串	無	http://f11.wretch.yimg.com/openapi01/2/thumbs/t1401889777.jpg?4hjKg09DcBbuRJihFIfNthmE85CoqgwkD3efYusHgtKaZoJadJObA.o3BRsR
lastModTime	否	日期	相簿最後修改時間 (YYYY-MM-DD HH:ii:ss)	無	2009-04-21 17:04:33
location_area	否	字串	相簿地點 - 區域	台灣	台灣
location_city	否	字串	相簿地點 - 城市	空字串	南投縣
num_pics	否	正整數	相簿內的相片數量	0	12
site_category_id	否	正整數	全站分類編號	0	112
site_category_name	否	字串	全站分類	空字串	國內旅遊
today_counter	否	正整數	當日人氣	0	39
total_counter	否	正整數	累積人氣	0	455
user_category_id	否	正整數	個人分類編號	0	2
user_category_name	否	字串	個人分類	空字串	test category 2
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <albums xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="0" xml:lang="en-US" yahoo:uri="http://www.wretch.cc/"> <album yahoo:xml="http://www.wretch.cc/album/openapi01"> <book_id>1</book_id> <cover>http://f11.wretch.yimg.com/openapi01/2/thumbs/t1401889777.jpg?4hjKg09DcBbuRJihFIfNthmE85CoqgwkD3efYusHgtKaZoJadJObA.o3BRsR</cover> <title>openapi test 1</title> <status>Public</status> <user_category_id>2</user_category_id> <user_category_name>test category 2</user_category_name> <site_category_id>112</site_category_id> <site_category_name>國內旅遊</site_category_name> <location_area>台灣</location_area> <location_city>南投縣</location_city> <num_pics>12</num_pics> <lastModTime>2009-04-21 17:04:33</lastModTime> <today_counter>39</today_counter> <total_counter>455</total_counter> <lang>zh-Hant-TW</lang> </album> <album yahoo:xml="http://www.wretch.cc/album/openapi01"> <book_id>2</book_id> <cover>http://pic.wretch.cc/e/icon/album/cover.gif?GhAR3HBSZAb0wCWygIaoWqENRagZJggdGNLpj6ME7mRkvPUZXqprd4nNDZJ12Zat</cover> <title>未命名相簿</title> <status>Private</status> <user_category_id>0</user_category_id> <user_category_name>未分類</user_category_name> <site_category_id>111</site_category_id> <site_category_name>拍賣</site_category_name> <location_area>台灣</location_area> <location_city>未分類</location_city/> <num_pics>2</num_pics> <lastModTime>2009-03-18 16:55:28</lastModTime> <today_counter>0</today_counter> <total_counter>0</total_counter> <lang>zh-Hant-TW</lang> </album> </albums>

albumService/{guid|wid}/album/{book_id} (POST)

功能說明 (Detail)

上傳一張照片並存入使用者的某一本相簿

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/albumService/{guid|wid}/{book_id}

通訊方式 (HTTP Method)

POST

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	3FH7YZZWCUXHOQJNY6AQZPGDOI 或 wretchuser
book_id	是	正整數	相簿編號	無	10

以下參數必須以 "XML的格式" 帶在 "Content" 中

參數名稱	是否必填	參數型態	說明	預設值	範例
content	是	圖片檔案內容	以 Base64 編碼後的照片內容	無	/9j/4AAQSkZJRgABAQEAYABgAAD/4QBmRXhpZgAASUkqAAgAAAAEABoBBQABAAAAPgAAABsBBQABAAAARgAAACgBAwABAAAAAgAAADEBAgAQAAAATgAAAAAAAABgAAAAAQAAAGAAAAABAAAAUGFpbnQuTkVUIHYzLjM2AP/bAEMAAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAf/bAEMBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAf/AABEIAAEAAQMBIgACEQEDEQH/xAAfAAABBQEBAQEBAQAAAAAAAAAAAQIDBAUGBwgJCgv/xAC1EAACAQMDAgQDBQUEBAAAAX0BAgMABBEFEiExQQYTUWEHInEUMoGRoQgjQrHBFVLR8CQzYnKCCQoWFxgZGiUmJygpKjQ1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4eLj5OXm5+jp6vHy8/T19vf4+fr/xAAfAQADAQEBAQEBAQEBAAAAAAAAAQIDBAUGBwgJCgv/xAC1EQACAQIEBAMEBwUEBAABAncAAQIDEQQFITEGEkFRB2FxEyIygQgUQpGhscEJIzNS8BVictEKFiQ04SXxFxgZGiYnKCkqNTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqCg4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2dri4+Tl5ufo6ery8/T19vf4+fr/2gAMAwEAAhEDEQA/APxfooor/Kc/7+D/2Q
title	是	字串	相片標題	無	阿里山遊記大合照
description	否	字串	相片描述	無	離開前在阿里山車站的團體大合照
quality	否	特定數字	縮圖品質: 0 (最佳品質), 1 (標準), 2 (最省空間)	1	3
thumb_type	否	特定字串	縮圖尺寸: small (640x640), medium (800x800), large (1024x1024), origin (原始尺寸)	small	large
upload_to_front	否	特定字串	上傳後將照片放在最前面: true (是), false (否)	false	true
exif_orientation	否	特定字串	上傳後依照 "相片資訊" 自動調正: true (是), false (否)	false	true

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/albumService/ZKWHF6P5LXDZSICROTM76OS4CI/album/1
或
http://wretch.yahooapis.com/v1.2/albumService/wretchuser/album/1

參數:

<?xml version="1.0" encoding="UTF-8"?>
<req>
  <title>myphoto</title>
  <content><[CDATA[/9j/4AAQSkZJRgABAQEAYABgAAD/4QBmRXhpZgAASUkqAAgAAAAEABoBBQABAAAAPgAAABsBBQABAAAARgAAACgBAwABAAAAAgAAADEBAgAQAAAATgAAAAAAAABgAAAAAQAAAGAAAAABAAAAUGFpbnQuTkVUIHYzLjM2AP/bAEMAAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAf/bAEMBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAf/AABEIAAEAAQMBIgACEQEDEQH/xAAfAAABBQEBAQEBAQAAAAAAAAAAAQIDBAUGBwgJCgv/xAC1EAACAQMDAgQDBQUEBAAAAX0BAgMABBEFEiExQQYTUWEHInEUMoGRoQgjQrHBFVLR8CQzYnKCCQoWFxgZGiUmJygpKjQ1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4eLj5OXm5+jp6vHy8/T19vf4+fr/xAAfAQADAQEBAQEBAQEBAAAAAAAAAQIDBAUGBwgJCgv/xAC1EQACAQIEBAMEBwUEBAABAncAAQIDEQQFITEGEkFRB2FxEyIygQgUQpGhscEJIzNS8BVictEKFiQ04SXxFxgZGiYnKCkqNTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqCg4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2dri4+Tl5ufo6ery8/T19vf4+fr/2gAMAwEAAhEDEQA/APxfooor/Kc/7+D/2Q]]></content>
</req>

回應參數 (Response Parameters)

回應範例 (Response Example)

上傳成功： <?xml version="1.0" encoding="UTF-8"?> <photos xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start='1' yahoo:total='1' yahoo:count='0' xml:lang="zh-TW" yahoo:uri='http://www.wretch.cc/'> </photos> 上傳失敗： <?xml version="1.0" encoding="UTF-8"?> <yahoo:error xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" xmlns="http://www.yahooapis.com/v1/schema.rng" xmlns:xml="http://www.w3.org/XML/1998/namespace" yahoo:uri="http://www.yahooapis.com/v1/errors/404/resource-not-found-generic" xml:lang="zh-TW"> <yahoo:description>Resource Not Found.</yahoo:description> <yahoo:detail>The resource you requested could not be found. </yahoo:detail> </yahoo:error>

albumService/{guid|wid}/album/{book_id}/photo/{photo_id}

功能說明 (Detail)

取得 user 的某一張相片的相關資訊 (Retrieve detail information for specific photo)

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/albumService/{guid|wid}/album/{book_id}/photo/{photo_id}

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
book_id	是	正整數	相簿編號	無	2
photo_id	是	正整數	相片編號	無	1401889757

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/albumService/6GEBDOA3NFVOOXL5TZVBDGNZNI/album/2/photo/1401889757
or
http://wretch.yahooapis.com/v1.2/albumService/openapi01/album/2/photo/1401889757

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
title	是	字串	相片名稱	無	4903865438_f5deca59d7_m
description	否	字串	相片描述	無
pic_url	是	字串	相片連結	無
thumb_url	是	字串	相片縮圖連結	無
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8" ?> <photo xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" xml:lang="en-US" yahoo:uri="http://www.wretch.cc/album/openapi01"> <title>4903865438_f5deca59d7_m</title> <description /> <pic_url>http://f11.wretch.yimg.com/openapi01/2/1401889757.jpg?HG93IjBDcBZoNmhcr5qjb_.9r28MjoXph08kwM.gDSLeXoqPj4cxAcDHdoNE</pic_url> <thumb_url>http://f11.wretch.yimg.com/openapi01/2/thumbs/t1401889757.jpg?HG93IjBDcBZoNmhcr5qjb_.9r28MjoXph08kwM.gDSLeXoqPj4cxAcDHdoNE</thumb_url> <lang>zh-Hant-TW</lang> </photo>

albumService/{guid|wid}/album/{book_id}

功能說明 (Detail)

取得 User 某一本相簿之相片列表

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/albumService/{guid|wid}/album/{book_id}

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid or wid	是	字串	user guid or wid		6GEBDOA3NFVOOXL5TZVBDGNZNI or openapi01
book_id	是	正整數	album id		2
start	否	正整數	從第幾筆開始抓取	1	1
count	否	正整數	回傳筆數,預設20張相片,最多20張	20	20

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/albumService/6GEBDOA3NFVOOXL5TZVBDGNZNI/album/2?format=xml http://wretch.yahooapis.com/v1.2/albumService/openapi01 /album/2?format=xml&start=1&count=20

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
album_name	是	字串	album_name	無	openapi test 1
book_id	是	字串	book id	無	2
photo_id	是	正整數	photo id	無	1401889777
thumb_url	是	字串	small photo url	無	http://f11.wretch.yimg.com/openapi01/2/thumbs/t1401889777.jpg?4hjKg09DcBbuRJihFIfNthmE85CoqgwkD3efYusHgtKaZoJadJObA.o3BRsR
img	是	字串	photo url	無	http://f11.wretch.yimg.com/openapi01/2/1401889777.jpg?4hjKg09DcBbuRJihFIfNthmE85CoqgwkD3efYusHgtKaZoJadJObA.o3BRsR
title	是	字串	photo title	無	IMG_0433
description	是	字串	photo description	無	2
lang	是	字串	language	無	zh-Hant-TW

回應範例 (Response Example)

<photos yahoo:start="2" yahoo:total="2" yahoo:count="0" xml:lang="en-US" yahoo:uri="http://www.wretch.cc/"> <photo yahoo:xml="http://www.wretch.cc/album/show.php?i=openapi01&b=2&f=1401889777"> <album_name>openapi test 1</album_name> <book_id>2</book_id> <photo_id>1401889777</photo_id> <thumb_url>http://f11.wretch.yimg.com/openapi01/2/thumbs/t1401889777.jpg?4hjKg09DcBbuRJihFIfNthmE85CoqgwkD3efYusHgtKaZoJadJObA.o3BRsR</thumb_url> <img>http://f11.wretch.yimg.com/openapi01/2/1401889777.jpg?4hjKg09DcBbuRJihFIfNthmE85CoqgwkD3efYusHgtKaZoJadJObA.o3BRsR</img> <title>IMG_0433</title> <description/> <lang>zh-Hant-TW</lang> </photo> <photo yahoo:xml="http://www.wretch.cc/album/show.php?i=openapi01&b=2&f=1401889778"> <album_name>openapi test 1</album_name> <book_id>2</book_id> <photo_id>1401889778</photo_id> <thumb>http://f11.wretch.yimg.com/openapi01/2/thumbs/t1401889778.jpg?f5KBDWVDcBYDfV6GL8mNxIPAz0kzZbm.KgDljSap6YIK_4I6gK8lG8_UhdKo</thumb> <img>http://f11.wretch.yimg.com/openapi01/2/1401889778.jpg?f5KBDWVDcBYDfV6GL8mNxIPAz0kzZbm.KgDljSap6YIK_4I6gK8lG8_UhdKo</img> <title>IMG_0434</title> <description/> <lang>zh-Hant-TW</lang> </photo> <photo yahoo:xml="http://www.wretch.cc/album/show.php?i=openapi01&b=2&f=1401889779"> <album_name>openapi test 1</album_name> <book_id>2</book_id> <photo_id>1401889779</photo_id> <thumb>http://f11.wretch.yimg.com/openapi01/2/thumbs/t1401889779.jpg?xYLK5ONDcBYsJH32.3KF2hyHNYSbvV4.wLi4YoUB51TsTNetSCJsS5P556A.</thumb> <img>http://f11.wretch.yimg.com/openapi01/2/1401889779.jpg?xYLK5ONDcBYsJH32.3KF2hyHNYSbvV4.wLi4YoUB51TsTNetSCJsS5P556A.</img> <title>IMG_0435</title> <description/> <lang>zh-Hant-TW</lang> </photo> </photos>

profileService/{guid|wid}

功能說明 (Detail)

取得使用者的個人名片資訊

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/profileService/{guid|wid}

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch ID)	無	3FH7YZZWCUXHOQJNY6AQZPGDOI 或 wretchuser

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/ProfileService/3FH7YZZWCUXHOQJNY6AQZPGDOI
或
http://wretch.yahooapis.com/v1.2/ProfileService/wretchuser

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
title	否	字串	標題	無	無名正妹
title_status	是	指定字串	"標題" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
description	否	字串	描述	無	無名第一正妹就是我
description_status	是	指定字串	"描述" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
nickname	否	字串	暱稱	無	正妹
nickname_status	是	指定字串	"暱稱" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
birthday	否	日期字串 (月/日)	生日	無	12/31
birthday_status	是	指定字串	"生日" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
introduction	否	字串	關於我	無	我是超級正妹
introduction_status	是	指定字串	"關於我" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
gender	否	指定字串	性別: Reserved (保留), Male (男), Female (女)	無	Female
gender_status	是	指定字串	"性別" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
uri	是	網址	使用者名片頁網址	無	http://www.wretch.cc/user/wretchoffice
astrology	否	字串	星座	無	雙子座
astrology_status	是	指定字串	"星座" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
height	否	字串	身高	無	171~180
height_status	是	指定字串	"身高" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
weight	否	字串	體重	無	46~50
weight_status	是	指定字串	"體重" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
blood_type	否	字串	血型	無	AB
blood_type_status	是	指定字串	"血型" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
career	否	字串	職業	無	資訊
career_status	是	指定字串	"職業" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
company	否	字串	公司名稱	無	雅虎奇摩
company_status	是	指定字串	"公司名稱" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
elementary_school	否	字串	國民小學	無	臺北市立東門國民小學
elementary_school_status	是	指定字串	"國民小學" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
junior_high_school	否	字串	國民中學	無	臺北市立中正國民中學
junior_high_school_status	是	指定字串	"國民中學" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
senior_high_school	否	字串	高中/職	無	臺北市立第一女子高級中學
senior_high_school_status	是	指定字串	"高中/職" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
university	否	字串	大專院校	無	國立台灣大學
university_status	是	指定字串	"大專院校" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
graduate_school	否	字串	研究所	無	哈佛大學
graduate_school_status	是	指定字串	"研究所" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
optional_school	否	字串	學歷自填	無	國立交通大學
optional_school_status	是	指定字串	"學歷自填" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
interests	否	字串	興趣	無	電腦網路,聊天哈拉,唱歌跳舞
interests_status	是	指定字串	"興趣" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
optional_interests	否	字串	興趣自填	無	公益活動
optional_interests_status	是	指定字串	"興趣自填" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
likes	否	字串	喜歡的	無	知心朋友
likes_status	是	指定字串	"喜歡的" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
dislikes	否	字串	討厭的	無	族群對立
dislikes_status	是	指定字串	"討厭的" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
email	否	字串	Email	無	username@yahoo.com
email_status	是	指定字串	"Email" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
msn	否	字串	MSN 帳號	無	username@hotmail.com
msn_status	是	指定字串	"MSN 帳號" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
yim	否	字串	YIM 帳號	無	username
yim_status	是	指定字串	"YIM 帳號" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
qq	否	字串	QQ 帳號	無	username
qq_status	是	指定字串	"QQ 帳號" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
aim	否	字串	AIM 帳號	無	username
aim_status	是	指定字串	"AIM 帳號" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
google	否	字串	Google Talk 帳號	無	username
google_status	是	指定字串	"Google Talk 帳號" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
skype	否	字串	Skype 帳號	無	username
skype_status	是	指定字串	"Skype 帳號" 隱私狀態: Public (顯示), Private (隱藏)	Public	Private
lang	是	指定字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

查詢成功： <?xml version="1.0" encoding="UTF-8"?> <profile xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" xml:lang="en-US" yahoo:uri="http://www.wretch.cc/user/someone"> <title>someone的個人名片</title> <description>someone的個人名片</description> <nickname>someone</nickname> <birthday>12/31</birthday> <introduction>關於我</introduction> <gender>Male</gender> <lang>zh-Hant-TW</lang> <astrology>魔羯座</astrology> <height>178</height> <weight>76</weight> <blood_type>A</blood_type> <career>農漁牧</career> <company>某某公司</company> <elementary_school>某某國民小學</elementary_school> <junior_high_school>某某國民中學</junior_high_school> <senior_high_school>某某高級中學</senior_high_school> <college>某某大學</college> <graduate_school>某某研究所</graduate_school> <optional_school>某某學校</optional_school> <interests>釣魚,溜冰</interests> <optional_interests>天天寫程式</optional_interests> <likes>哈哈大笑</likes> <dislikes>洗澡沒熱水</dislikes> <email>user@yahoo.com</email> <msn>user@hotmail.com</msn> <yim>user@yahoo.com</yim> <qq>user@qq.com</qq> <aim>user@aol.com</aim> <google>user@gmail.com</google> <skype>user@skype.com</skype> </profile> 查詢失敗： <?xml version="1.0" encoding="UTF-8"?> <yahoo:error xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" xmlns="http://www.yahooapis.com/v1/schema.rng" xmlns:xml="http://www.w3.org/XML/1998/namespace" yahoo:uri="http://www.yahooapis.com/v1/errors/404/resource-not-found-generic" xml:lang="zh-TW"> <yahoo:description>Resource Not Found.</yahoo:description> <yahoo:detail>The resource you requested could not be found. </yahoo:detail> </yahoo:error>

profileService/{guid|wid}/cover

功能說明 (Detail)

取得使用者大頭貼圖片路徑

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/profileService/{guid|wid}/cover

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch ID)	無	3FH7YZZWCUXHOQJNY6AQZPGDOI 或 wretchuser

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/profileService/6GEBDOA3NFVOOXL5TZVBDGNZNI/cover?format=xml
或
http://wretch.yahooapis.com/v1.2/profileService/openapi01/cover?format=xml

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
small	是	URL 字串	大頭貼小型圖片網址	無	http://l.yimg.com/e/cover/wretchuser_60.jpg?25
medium	是	URL 字串	大頭貼中型圖片網址	無	http://l.yimg.com/e/cover/wretchuser_90.jpg?25
large	是	URL 字串	大頭貼大型圖片網址	無	http://l.yimg.com/e/cover/wretchuser_150.jpg?25
origin	是	URL 字串	大頭貼原始圖片網址	無	http://l.yimg.com/e/cover/wretchuser.jpg?25
nickname	是	字串	使用者暱稱	無	無名正妹
lang	是	特定字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

查詢成功： <?xml version="1.0" encoding="UTF-8"?> <cover xml:lang="zh-TW" yahoo:uri="http://www.wretch.cc/user/wretchuser"> <small>http://l.yimg.com/e/cover/wretchuser_60.jpg?25</small> <medium>http://l.yimg.com/e/cover/wretchuser_90.jpg?25</medium> <large>http://l.yimg.com/e/cover/wretchuser_150.jpg?25</large> <origin>http://l.yimg.com/e/cover/wretchuser.jpg?25</origin> <nickname>無名正妹</nickname> <lang>zh-Hant-TW</lang> </cover> 查詢失敗： <?xml version="1.0" encoding="UTF-8"?> <yahoo:error xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" xmlns="http://www.yahooapis.com/v1/schema.rng" xmlns:xml="http://www.w3.org/XML/1998/namespace" yahoo:uri="http://www.yahooapis.com/v1/errors/404/resource-not-found-generic" xml:lang="zh-TW"> <yahoo:description>Resource Not Found.</yahoo:description> <yahoo:detail>The resource you requested could not be found. </yahoo:detail> </yahoo:error>

videoService/{guid|wid}/videos

功能說明 (Detail)

取得指定的使用者的影音列表. 類似 http://www.wretch.cc/video/{wid}&func=d_list&view=list&o=time_d 的功能.

回應的內容會依照訪客的身分而有所不同.

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/videoService/{guid|wid}/videos

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
start	否	正整數	從第幾筆開始抓取	1	1
count	否	正整數	回傳筆數，預設 20 筆，最多 20 筆	20	20

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/videoService/6GEBDOA3NFVOOXL5TZVBDGNZNI/videos?start=1&count=10
或
http://wretch.yahooapis.com/v1.2/videoService/openapi01/videos?start=1&count=10

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
video_id	是	正整數	影片編號	無	6023105
title	是	字串	影片標題	無	神祕經典
length	是	正整數	影片長度, 單位是秒	無	62
description	否	字串	影片敘述	無	Mo~~~
post_time	是	日期字串	影片發表時間 (年-月-日時:分:秒)	無	2011-01-19 15:12:45
status	是	指定字串	保護方式: Public(公開), Private(隱藏), Password_Protected(通關密碼), Friends_Only(好友保護)	無	Public
site_category_id	是	正整數	全站分類編號	無
site_category_name	是	字串	全站分類	無
user_category_id	是	正整數	個人分類編號	無
user_category_name	是	字串	個人分類	無
total_counter	是	正整數	瀏覽	0	0
total_comment	是	正整數	回應	0	0
total_trackback	是	正整數	引用	0	0
total_collection	是	正整數	收藏	0	0
thumb_url	是	網址	影片縮圖網址	無
url	是	網址	單一影片的網頁網址	無
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <videos xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="1" yahoo:count="0" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <video yahoo:uri="http://www.wretch.cc/video/openapi01"> <video_id>8102391</video_id> <title><[CDATA[淡水河]]></title> <length>62</length> <description></description> <post_time>2011-01-19 15:19:34</post_time> <status>Friend_Only</status> <site_category_id><site_category_id> <site_category_name></site_category_id> <user_category_id></user_category_id> <user_category_name><[CDATA[]]></user_category_name> <total_counter>4</total_counter> <total_comment></total_comment> <total_trackback></total_trackback> <total_collection></total_collection> <thumb_url></thumb_url> <url></url> <lang>zh-Hant-TW</lang> </video> <video yahoo:uri="http://www.wretch.cc/video/openapi01"> <video_id>8102435</video_id> <title><[CDATA[冬山河]]></title> <length>4</length> <description><[CDATA[Moo]]></description> <post_time>2011-01-19 15:12:54</post_time> <status>Public</status> <site_category_id>5<site_category_id> <site_category_name>國內旅遊</site_category_id> <user_category_id>0</user_category_id> <user_category_name><[CDATA[]]></user_category_name> <total_counter>7</total_counter> <total_comment>1</total_comment> <total_trackback>0</total_trackback> <total_collection>0</total_collection> <thumb_url>http://f10.wretch.yimg.com/openapi01/2/thumbs/t1707156135.jpg?6z7X.N9DcxbDO_0nzM5Qq56Ge3Lfm0C0HpcPY9uMcYtrqM044DfpUlafhh8Ze5Q-</thumb_url> <url>http://116.214.13.48/wretchoffice/79/1945049351.flv</url> <lang>zh-Hant-TW</lang> </video> </videos>

videoService/{guid|wid}/videos (POST)

功能說明 (Detail)

上傳一則影音. 類似 http://www.wretch.cc/video/yuiuploader.php 的功能.

關於 friend_group, 在網頁上的行為是在沒有好友群組的時候會讓你選 0, 也就是開放給所有好友. 但是在有好友群組的時候, 下拉選單就不再有這個選項可以選. 目前的決定是, 在 API 裡面使用者永遠都有 0 可以選擇.

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/videoService/{guid|wid}/videos

通訊方式 (HTTP Method)

POST

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01

以下參數必須以 "XML的格式" 帶在 "Content" 中

參數名稱	是否必填	參數型態	說明	預設值	範例
content	是	圖片檔案內容	以 Base64 編碼後的影音內容	無
title	是	字串	影片標題	無	神祕經典
description	否	字串	影片敘述	無	Mo~~~
status	否	指定字串	保護方式: Public(公開), Private(隱藏), Password_Protected(通關密碼), Friends_Only(好友保護)	Public	Public
key	否	字串	通關密碼. 只有在保護方式是 Password_Protected 的時候此參數才有意義,key 至少五個字數,且需同時包含英文字母與數字	無	25th-April
key_note	否	字串	通關密碼提示	無	我的生日
friend_group	否	正整數	好友保護的群組編號. 只有在保護方式是 Friend_only 的時候此參數才有意義. 預設是開放給所有好友.	0	0
site_category_id	是	正整數	全站分類編號	無
user_category_id	否	正整數	個人分類編號	0
allow_comment	否	指定字串	回應權限: wide_open, Members_Only, Friends_Only, No_one	wide_open
book_id	是	正整數	相簿編號	無	1
quality	否	指定數字	上傳品質: 0 (最佳品質), 1 (標準), 2 (最省空間)	1	3

需求範例 (Request Example)

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
video_id	是	正整數	影音編號	無	6023105
thumb_url	是	網址	影音縮圖網址	無	http://f5.wretch.yimg.com/wretchoffice/79/thumbs/t1945049351.jpg?mvAxh55DfRLmGMKl4lR6OsvIw_sq2Y7Tn58rn58SnFFab2ur.6p77husVRD_uOiPWa.rwIY-
url	是	網址	影音網址	無	http://116.214.13.48/wretchoffice/79/1945049351.flv
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <videos xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="1" yahoo:count="0" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <video yahoo:uri="http://www.wretch.cc/video/openapi01"> <video_id>8102391</video_id> <thumb_url>http://f10.wretch.yimg.com/openapi01/2/thumbs/t1707156135.jpg?6z7X.N9DcxbDO_0nzM5Qq56Ge3Lfm0C0HpcPY9uMcYtrqM044DfpUlafhh8Ze5Q-</thumb_url> <url>http://116.214.13.48/wretchoffice/79/1945049351.flv</url> <lang>zh-Hant-TW</lang> </video> <videos>

videoService/{guid|wid}/video/{video_id}

功能說明 (Detail)

取得指定的影音. 類似 http://www.wretch.cc/video/{wid}&func=single&vid={video_id} 的功能.

回應的內容會依照訪客的身分而有所不同.

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/videoService/{guid|wid}/video/{video_id}

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
video_id	是	正整數	影音編號	無	6023105

需求範例 (Request Example)

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
title	是	字串	影片標題	無	神祕經典
length	是	正整數	影片長度, 單位是秒	無	62
description	否	字串	影片敘述	無	Mo~~~
post_time	是	日期字串	影片發表時間 (年-月-日時:分:秒)	無	2011-01-19 15:12:45
status	是	指定字串	保護方式: Public(公開), Private(隱藏), Password_Protected(通關密碼), Friends_Only(好友保護)	無	Public
site_category_id	是	正整數	全站分類編號	無
site_category_name	是	字串	全站分類	無
user_category_id	是	正整數	個人分類編號	無
user_category_name	是	字串	個人分類	無
total_counter	是	正整數	瀏覽	0	0
total_comment	是	正整數	回應	0	0
total_trackback	是	正整數	引用	0	0
total_collection	是	正整數	收藏	0	0
thumb_url	是	網址	影片縮圖網址	無
url	是	網址	影片檔案的網址, 也就是 flash player 背後的 .flv 檔案	無
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <video xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <title><[CDATA[冬山河]]></title> <length>4</length> <description><[CDATA[Moo]]></description> <post_time>2011-01-19 15:12:54</post_time> <status>Public</status> <site_category_id>5<site_category_id> <site_category_name>國內旅遊</site_category_id> <user_category_id>0</user_category_id> <user_category_name><[CDATA[]]></user_category_name> <total_counter>7</total_counter> <total_comment>1</total_comment> <total_trackback>0</total_trackback> <total_collection>0</total_collection> <thumb_url>http://f10.wretch.yimg.com/openapi01/2/thumbs/t1707156135.jpg?6z7X.N9DcxbDO_0nzM5Qq56Ge3Lfm0C0HpcPY9uMcYtrqM044DfpUlafhh8Ze5Q-</thumb_url> <url>http://116.214.13.48/wretchoffice/79/1945049351.flv</url> <lang>zh-Hant-TW</lang> </video>

friendService/{guid|wid}/friends

功能說明 (Detail)

取得此使用者設為好友的列表功能.

取得此使用者的 '我的好友'

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/friendService/{guid|wid}/friends

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
start	否	正整數	從第幾筆開始抓取	1	1
count	否	正整數	回傳筆數，預設 20 筆，最多 20 筆	20	20

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/friendService/6GEBDOA3NFVOOXL5TZVBDGNZNI/friends
or
http://wretch.yahooapis.com/v1.2/friendService/openapi01/friends

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
friend_userid	是	字串	好友無名帳號	無	openapi07
friend_url	是	字串	該無名帳號的好友URL	無	http://www.wretch.cc/friend/openapi07
cover_url	是	字串	大頭貼中型圖片網址	無	http://cover.wretch.cc/openapi07_90.jpg?0
status	是	指定字串	好友狀態: Public(公開), Private(隱藏)	無	Private
friend_group	是	字串	好友類別	無	大學同學
description	是	字串	好友描述	無	宅男,目前單身,無不良嗜好
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <friends xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="2" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <friend yahoo:uri="http://www.wretch.cc/friend/openapi07"> <friend_userid>openapi07</friend_userid> <friend_url>http://www.wretch.cc/friend/openapi07</friend_url> <cover_url>http://cover.wretch.cc/openapi07_90.jpg?0</cover_url> <status>Public</status> <friend_group>預設類別</friend_group> <description>宅男,目前單身,無不良嗜好</description> <lang>zh-Hant-TW</lang> </friend> <friend yahoo:uri="http://www.wretch.cc/friend/openapi01"> <friend_userid>openapi01</friend_userid> <friend_url>http://www.wretch.cc/friend/openapi01</friend_url> <cover_medium>http://cover.wretch.cc/openapi01_90.jpg?0</cover_medium> <status>Public</status> <friend_group>預設類別</friend_group> <description>工程師,已婚</description> <lang>zh-Hant-TW</lang> </friend> </friends>

friendService/{guid|wid}/mutualFriends

功能說明 (Detail)

取得此使用者互為好友的列表功能.

取得此使用者的'互為好友'列表

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/friendService/{guid|wid}/mutualFriends

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
start	否	正整數	從第幾筆開始抓取	1	1
count	否	正整數	回傳筆數，預設 20 筆，最多 20 筆	20	20

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/friendService/6GEBDOA3NFVOOXL5TZVBDGNZNI/mutualFriends
or
http://wretch.yahooapis.com/v1.2/friendService/openapi01/mutualFriends

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
friend_userid	是	字串	好友無名帳號	無	openapi07
friend_url	是	字串	該無名帳號的好友URL	無	http://www.wretch.cc/friend/openapi07
cover_url	是	字串	大頭貼中型圖片網址	無	http://cover.wretch.cc/openapi07_90.jpg?0
description	是	字串	好友描述	無	宅男,目前單身,無不良嗜好
friend_group	是	字串	好友類別	無	大學同學
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <mutualFriends xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="2" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <mutualFriend yahoo:uri="http://www.wretch.cc/friend/openapi02"> <friend_userid>openapi02</friend_userid> <friend_url>http://www.wretch.cc/friend/openapi02</friend_url> <cover_url>http://cover.wretch.cc/openapi02_90.jpg?1</cover_url> <description>可愛的小朋友</description> <friend_group>預設類別</friend_group> <lang>zh-Hant-TW</lang> </mutualFriend> <mutualFriend yahoo:uri="http://www.wretch.cc/friend/openapi06"> <friend_userid>openapi06</friend_userid> <friend_url>http://www.wretch.cc/friend/openapi06</friend_url> <cover_url>http://cover.wretch.cc/openapi06_90.jpg?0</cover_url> <description>宅男工程師</description> <friend_group>預設類別</friend_group> <lang>zh-Hant-TW</lang> </mutualFriend> </mutualFriends>

friendService/{guid|wid}/reverseFriends

功能說明 (Detail)

取得此使用者加為好友的列表功能.

取得此使用者的'加為好友'列表

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/friendService/{guid|wid}/reverseFriends

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
guid 或 wid	是	字串	使用者的 GUID 或無名帳號 (Wretch id)	無	6GEBDOA3NFVOOXL5TZVBDGNZNI 或 openapi01
start	否	正整數	從第幾筆開始抓取	1	1
count	否	正整數	回傳筆數，預設 20 筆，最多 20 筆	20	20

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/friendService/6GEBDOA3NFVOOXL5TZVBDGNZNI/reverseFriends
or
http://wretch.yahooapis.com/v1.2/friendService/openapi01/reverseFriends

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
friend_userid	是	字串	好友無名帳號	無	openapi07
friend_url	是	字串	該無名帳號的好友URL	無	http://www.wretch.cc/friend/openapi07
cover_url	是	字串	大頭貼中型圖片網址	無	http://cover.wretch.cc/openapi07_90.jpg?0
description	是	字串	好友描述	無	宅男,目前單身,無不良嗜好
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <reverseFriends xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="1" yahoo:count="0" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <reverseFriend yahoo:uri="http://www.wretch.cc/friend/openapi02"> <friend_userid>openapi02</friend_userid> <friend_url>http://www.wretch.cc/friend/openapi02</friend_url> <cover_url>http://cover.wretch.cc/openapi02_90.jpg?1</cover_url> <description>可愛的小朋友</description> <lang>zh-Hant-TW</lang> </reverseFriend> <reverseFriend yahoo:uri="http://www.wretch.cc/friend/openapi06"> <friend_userid>openapi06</friend_userid> <friend_url>http://www.wretch.cc/friend/openapi06</friend_url> <cover_url>http://cover.wretch.cc/openapi06_90.jpg?0</cover_url> <description>宅男工程師</description> <lang>zh-Hant-TW</lang> </reverseFriend> </reverseFriends>

siteAlbumCategories

功能說明 (Detail)

取得相簿全站分類列表

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/siteAlbumCategories

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

無

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/siteAlbumCategories

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
category_id	是	正整數	分類編號	無	112
description	是	字串	分類描述	無	美食記錄(餐廳、小吃、咖啡館、烹飪)
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <site_album_categories xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="2" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <site_album_category yahoo:uri="http://www.wretch.cc/album/"> <category_id>113</category_id> <description>國外旅遊(大陸地區、歐亞美澳、其他)</description> <lang>zh-Hant-TW</lang> </site_album_category> <site_album_category yahoo:uri="http://www.wretch.cc/album/"> <category_id>12</category_id> <description>美食記錄(餐廳、小吃、咖啡館、烹飪)</description> <lang>zh-Hant-TW</lang> </site_album_category> </site_album_categories>

siteVideoCategories

功能說明 (Detail)

取得相簿全站分類列表

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/siteVideoCategories

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

無

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/siteVideoCategories

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
category_id	是	正整數	分類編號	無	2
description	是	字串	分類描述	無	國內旅遊(台灣本島、離島、其他)
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <site_video_categories xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="2" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <site_video_category yahoo:uri="http://www.wretch.cc/video/"> <category_id>2</category_id> <description>國內旅遊(台灣本島、離島、其他)</description> <lang>zh-Hant-TW</lang> </site_video_category> <site_video_category yahoo:uri="http://www.wretch.cc/video/"> <category_id>3</category_id> <description>國外旅遊(大陸地區、歐亞美澳、其他)</description> <lang>zh-Hant-TW</lang> </site_video_category> </site_video_categories>

siteBlogCategories

功能說明 (Detail)

取得網誌全站分類列表

連接網址 (URL)

http://wretch.yahooapis.com/v1.2/siteBlogCategories

通訊方式 (HTTP Method)

GET

需求參數 (Request Parameters)

無

需求範例 (Request Example)

http://wretch.yahooapis.com/v1.2/siteBlogCategories

回應參數 (Response Parameters)

參數名稱	是否必填	參數型態	說明	預設值	範例
category_id_layer1	是	正整數	第一層分類編號	無	52
category_id_layer2	是	正整數	第二層分類編號	無	20
category_id_layer3	是	正整數	第三層分類編號	無	229
description_layer1	是	字串	第一層分類描述	無	心情
description_layer2	是	字串	第二層分類描述	無	個人
description_layer3	是	字串	第三層分類描述	無	心情小語
lang	是	字串	語系	zh-Hant-TW	zh-Hant-TW

回應範例 (Response Example)

<?xml version="1.0" encoding="UTF-8"?> <site_blog_categories xmlns="http://w10.api.wretch.tp2.yahoo.net/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="1" yahoo:total="2" yahoo:count="2" xml:lang="zh-Hant-TW" yahoo:uri="http://www.wretch.cc/"> <site_blog_category yahoo:uri="http://www.wretch.cc/blog/"> <category_id_layer1>52</category_id_layer1> <category_id_layer2>20</category_id_layer2> <category_id_layer3>229</category_id_layer3> <description_layer1>心情</description_layer1> <description_layer2>個人</description_layer2> <description_layer3>心情小語</description_layer3> <lang>zh-Hant-TW</lang> </site_blog_category> <site_blog_category yahoo:uri="http://www.wretch.cc/blog/"> <category_id_layer1>52</category_id_layer1> <category_id_layer2>20</category_id_layer2> <category_id_layer3>203</category_id_layer3> <description_layer1>心情</description_layer1> <description_layer2>個人</description_layer2> <description_layer3>男人話題</description_layer3> <lang>zh-Hant-TW</lang> </site_video_category> </site_video_categories>

Yahoo! Services

Yahoo!奇摩搜尋

無名小站 API 文件 - Version 1.2

API 中需驗證的方法

API 存取方式:

API 的輸出格式:

API 方法列表：

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)

需求參數 (Request Parameters)

需求範例 (Request Example)

回應參數 (Response Parameters)

回應範例 (Response Example)

功能說明 (Detail)

連接網址 (URL)

通訊方式 (HTTP Method)