Plurk API 2.0

Plurk API 2.0 是遵循 OAuth 1.0a 開放標準來保護使用者的隱私安全，它提供應用程式在 Plurk 平台上訪問和簽證等等的標準方式，應用程式可以讀取使用者的河道、發表噗文，並且基於使用者的利益，不會保留使用者的密碼，所以鼓勵所有希望訪問使用者資訊的應用程式盡快轉移到 Plurk API 2.0 OAuth。

附註說明：OAuth（開放授權）是一個開放標準，允許用戶讓第三方應用存取該用戶在某一網站上儲存的私密的資源（如相片，影片，聯絡人列表），而無需將使用者名稱和密碼提供給第三方應用。

立即註冊自己的 Plurk 應用程式！或者在這裡管理您創建的 Plurk 應用程式。

Plurk API 2.0 與我們原先基於 session-based Plurk API 1.0 之間的差異：

Plurk API 2.0 是無狀態的(不需要登入使用者帳號)，而原先 Plurk API 1.0 是基於 session-based 的。
Plurk API 2.0 URL 前綴，帶有 https://www.plurk.com/APP/ ，而不是原先的 https://www.plurk.com/API/ 。
Plurk API 2.0 的請求必須遵循 OAuth Core 1.0a 標準規範來進行簽章。
輸出與輸出的參數與原先 Plurk API 1.0 相同，但 Plurk API 2.0 不需要「api_key」。

在使用 API 之前，Plurk API 2.0 應用程式必須遵循 OAuth 的開放標準來獲得使用者的 Token。大多數的 API 使用 Three-Legged OAuth，它需要透過使用者金鑰/密鑰和 Token 金鑰/密鑰來簽證請求。然而有一些 API 還支持 Two-Legged OAuth，該請求可以使用應用程式金鑰/密鑰進行簽證。

附註說明：Three-Legged OAuth，意指用戶授權過程當中涉及三種角色，分別為應用程式(Application)、服務提供者(Service Provider)、使用者(User)

附註說明：Two-Legged OAuth，則是授權過程只涉及兩種角色，分別為應用程式(Application)、服務提供者(Service Provider)

如果您是機器人的開發人員或單獨只是給自己玩的使用者，則可以使用我們的測試控制台獲取您自己的永久 Token，您不需要撰寫程式碼來獲取 Token。

Plurk API 2.0 的資料返回是 JSON 文字格式，所以您應該使用 JSON 套件來解碼返回的資料。

OAuth 的流程及服務端口

一般來說，應用程式必須透過以下步驟，才能獲取使用者的 Token。

在這裡註冊獲取 Plurk 應用程式金鑰/密鑰(OAuth 應用程式金鑰/密鑰)
請求臨時 Token (OAuth 回應 Token)
將使用者導向到 Plurk 以授權權限
在回應當中接收 OAuth 驗證
請求永久使用者 Token (OAuth 使用者 Token)

獲取使用者的 Token 金鑰/密鑰後，應用程式就可以開始簽署請求，以使用任何 Plurk API 2.0 的功能。

Plurk OAuth 的服務端口：

獲取請求 Token => https://www.plurk.com/OAuth/request_token (HTTPS GET/POST)
授權頁面(網頁) => https://www.plurk.com/OAuth/authorize
授權頁面(手機) => https://www.plurk.com/m/authorize
請求使用者 Token => https://www.plurk.com/OAuth/access_token (HTTPS GET/POST)

支持多種設備

您還可以將可選參數 "deviceid(裝置)" 傳遞給授權頁面，從而使您的應用程式能夠使用相同的 Plurk 帳號安裝在多個設備上。倘若以前使用過相同 "deviceid(裝置)" 登入應用服務，將會把以前的 Token 覆蓋掉。另外還可以傳遞另一個可選參數 "model"，以便有意義的 model 名稱來識別使用者的裝置。例如：

1	https://www.plurk.com/OAuth/authorize?oauth_token=ReqKMrVIjOLI&deviceid=efa9183a839f421821dc5c&model=Apple+iPhone+4S

"deviceid" 的最大長度為 32 個字符，默認值為空("")，您應該使用唯一的 ID (例如 UUID)來識別使用者的裝置，例如："ab21862c272bbd703ef9d5b35458b78d"，該 model 名稱或 "deviceid" 將顯示在使用者的我授權的 Plurk 應用服務頁面中，使用有意義的裝置名稱可以幫助使用者輕鬆識別他的授權裝置。