無名小站 API 文件 - Version 1.0

使用 Yahoo!奇摩無名小站 API，開發者可以取得以 XML 或 JSON 為格式的 無名小站資料，也包含了寫入及更新。 例如上傳照片影音、撰寫文章，以及會員的好友關係。由於無名屬於以使用者為中心的社群網站，透過 API，使用者能在其他無名小站以外的網站，寫入、使用個人的服務資料。

新手上路

1. 取得應用程式帳號

   在開發程式前你需要先取得應用程式帳號（AppID），藉由此 AppID 您才有取得及寫入無名小站API的權限。

2. 學習如何使用 OAuth

   所有無名小站上的非公開個人資料都需要透過 OAuth 做使用者授權後方得使用。

3. 常見問題集

   無名小站提供了常見問題集，您也許可以在這邊找到答案。（按此觀看）

4. 閱讀技術文件

   無名小站提供了 API 文件讓您查詢有那些方法可使用。（按此觀看）

如何使用無名小站 API

API 中需驗證的方法

所有與使用者私人資料有關的都需要使用 OAuth 做驗證，請參考此篇文章：OAuth Authentication Model

API 存取方式：

http://api.wretch.cc:4080/v1/[API Method]?[Parameters]

API 的輸出格式：

無名小站 API 提供兩種輸出格式：XML 與 JSON，可使用 format 參數來指定回傳的格式 (例如：format=json)， 或在發出 Request 時，指定 header 為 application/xml 或 application/json。

無名小站的 APIs：

Upload 相片、影片上傳 : 照片/影音/新增相簿

這一系列的 APIs 可以協助開發者與無名串接，主要可完成上傳照片、影片，以及新增一本相簿的功能。需配合 OAuth 的 API 來完成 Authentication。

APIs 的使用文件請點這裡。

Posting 撰寫文章 : 新文章/嘀咕訊息

這一系列的 APIs 主要串接的服務是網誌與嘀咕，包含撰寫新文章、發表(回覆)嘀咕訊息，請使用這類的APIs來完成。需配合 OAuth 的 API 來完成 Authentication。

APIs 的使用文件請點這裡。

(以上 Upload 相片、影片上傳與 Posting 撰寫文章需配合的 Argument)

Connection 社群好友關係 : 好友列表

這系列的 APIs 支援的是無名小站上的好友關係，依照無名小站好友關係的架構，可取得群組式好友列表、單一帳號下的好友列表以及互為好友的好友列表。

APIs 的使用文件請點這裡。

Get User Data 取得使用者資料 (需有使用者提供的認證)

這是個主題系列的APIs 群，區分為名片、相簿、網誌、影音、嘀咕這幾個無名小站主要的使用者個人服務。

• Profile Service 使用者個人名片

  在這個服務的 APIs 提供的資料內容，包含使用者所提供的個人資料，以及在無名小站上的個人識別大頭照。

  APIs 的使用文件請點這裡。

• Album Service 使用者個人相簿

  無名小站的相簿服務分為相簿列表、相片列表以及單張相片，相簿的 APIs 讓開發者可以取得使用者的相簿狀態、相簿列表、單本相簿底下的相片列表等內容。需配合 OAuth 的 API 來完成 Authentication。

  APIs 的使用文件請點這裡。

• Blog Service 使用者個人網誌

  網誌的 APIs 提供取得的內容包含使用者網誌狀態、個人網誌分類列表以及單篇文章的summary。需配合 OAuth 的 API 來完成 Authentication。

  APIs 的使用文件請點這裡。

• Video Service 使用者個人影音

  影音的 APIs 提供取得的內容包含使用者影音狀態、個人影音分類列表以及單則影音。需配合 OAuth 的 API 來完成 Authentication。

  APIs 的使用文件請點這裡。

• Digu Service 使用者個人嘀咕

  嘀咕是無名小站在 2008 年新推出的社交新服務，是一種類似微型部落格的產品。依照無名小站嘀咕的架構，APIs 提供取得的內容包含使用者嘀咕狀態、單則嘀咕以及定越、被訂閱列表等。需配合 OAuth 的 API 來完成 Authentication。

  APIs 的使用文件請點這裡。