Postman Tutorial: Disqus REST API #3

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串

在本文中,我們將繼續使用 Postman 探索 Disqus REST API。這次的重點是了解如何使用需要用戶驗證的API POST服務,例如創建、更新和刪除討論串。接下來的練習將需要 Disqus API 的 Access Token (存取憑證)。如果您不知道如何使用 OAuth 2.0 獲取存取憑證,請返回閱讀 Disqus REST API 案例研究(2)


練習 1- 創建一個新的 Disqus 討論串

threads/create

說明文件: https://disqus.com/api/docs/threads/create/

threads/create 端點是用來添加新的討論串至指定的討論區。一般情況之下,若您的網站安裝了 Disqus 的代碼或插件,一旦 Disqus 檢測到新的帖文,就會自動創建一個討論串。那麼,在哪兒用得上?

我認為您可以利用它將網站的留言遷移到 Disqus。您也可以使用它來建立離站的討論區,以利於從某個討論的主線中分離子題目。訪問 threads/create 端點的設置如下:

方法POST
網址https://disqus.com/api/3.0/threads/create.json
授權OAuth 2.0 (Request Headers)
請參閱 Disqus REST API 案例研究 (2)
api_key{{api_key}}
存儲在您作業環境中的公鑰
forumDisqus留言板的短名稱
title描述新 Disqus 討論串的名稱

執行前,請確認選擇的作業環境,以保證呼叫正確的環境變數。該 API 請求應如以下截圖所示:

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串 1

回應

JSON

在 JSON 格式的 API 回應中,找出並記下回傳的討論串 id。接下來,在更新和刪除討論串的時候會使用到它。在瀏覽器中打開於回應中 link 項的網址,確認新建的 Disqus 討論串。您應該到訪一個如以下截圖所示的 Disqus 網頁。

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串 2

[ 返回目錄 ]


練習 2- 更新 Disqus 討論串的資料數據

threads/update

說明文件: https://disqus.com/api/docs/threads/update/

threads/update 端點是 Disqus Help Desk 上建議的討論串網址更新方法之一。它也可以用來更改出現在Disqus 推薦中的帖子標題

例如,我們想要更改在練習1中創建的討論串之標題和連結。按照以下表格前五行中設置 Request,然後附加最後三行選項,以把新標題和新網頁地址分配給指定的討論串。

方法POST
網址https://disqus.com/api/3.0/threads/update.json
授權OAuth 2.0 (Request Headers)
請參閱 Disqus REST API 案例研究 (2)
api_key{{api_key}}
存儲在您作業環境中的公鑰
threadDisqus 討論串 ID
title
選項
例如: Hello World!!
最長200個字符
url
選項
例如: https://disqus.com/home/discussion/craftweeks/hello_world-2/
網頁地址 (RFC 3986定義, 最長500個字符)
slug
選項
例如: hello_world-2
字母數字符號 (最長200個字符)

提示: 要查詢討論串,亦必須知道其 ID 號碼。如果您不小心忘記了,請嘗試使用 Disqus REST API 案例研究(1) 一文中所述的方法索取 ID 的值。

執行前,請確認選擇的作業環境,以保證呼叫正確的環境變數。該 API 請求應如以下截圖所示:

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串 3
回應
JSON

等一會兒,然後在瀏覽器中重新加載頁面。Disqus 將表示原來頁面不存在。在網址欄中輸入新 URL,您應該到訪已更新標題的討論頁面。

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串 4

[ 返回目錄 ]


練習 3 – 刪除一個 Disqus 討論串

threads/remove

說明文件: https://disqus.com/api/docs/threads/remove/

探索完上述 API 服務之後,您可能希望刪除測試用的討論串。您可以使用以下的參數,訪問 threads/remove 端點:

方法POST
網址https://disqus.com/api/3.0/threads/remove.json
授權OAuth 2.0 (Request Headers)
請參閱 Disqus REST API 案例研究 (2)
api_key{{api_key}}
存儲在您作業環境中的公鑰
threadDisqus 討論串 ID

執行前,請確認選擇的作業環境,以保證呼叫正確的環境變數。該 API 請求應如以下截圖所示:

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串 5
回應
JSON

稍等片刻後,在瀏覽器中重新加載網頁。Disqus 將表示該頁面不再存在。

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串 6

[ 返回目錄 ]


使用線上討論編輯器檢查結果

Postman教學: Disqus REST API 案例研究(3) – 創建/更新/刪除討論串 7

討論編輯器 (Discussions Editor) 使您可以一鍵更新網站上任何討論串的屬性。例如,當您更新了您的網站之後,您可以更新與之相關的討論之標題或連結。

哪些屬性可以更新?

目前,可以進行更新的討論屬性,包含:

標題:公開顯示。
連結:公開顯示。
作者:非公開顯示。適用於當您希望將並非您 Disqus 討論區板主的用戶,作為討論的作者時進行更新。 這樣,他們就可以通過 Disqus 通知電郵和留言板,對該討論的留言內容進行審批。
類別:非公開顯示。類別主要用於在 Disqus API 過濾結果。了解有關類別的更多信息
開/關狀態:打開或關閉對新評論的討論。

如果您喜歡這篇文章,請分享到您的 Facebook 和 Twitter。您也可以通過 Ko-fi 捐款支持本站。

Scroll to Top