團隊動態
「動態分析」索引標籤可讓您掌握 API 資料的概況。您可以從這個主要中心快速查看 API 要求、簽署要求狀態,以及簽署要求用量示意圖表。您可以自訂這項資料的時間表顯示畫面,使用畫面頂端的下拉式選單選擇依照資料類型、日期範圍及錯誤狀態 (API 錯誤分布、端點或 HTTP 狀態) 顯示資料,也可以檢查應用程式和帳戶活動的紀錄。
您還可以在「動態分析」索引標籤中,查看額度使用量(剩餘的簽署要求次數)和基本帳單資訊。
簽署要求狀態
您可以在「簽署要求狀態」索引標籤中,查看文件 ID、簽署要求的狀態,以及事件的日期和時間。透過頁面頂端的下拉式選單,可依日期和簽署要求狀態篩選此頁的資訊。
應用程式 Callback
「應用程式 Callback」索引標籤可供您設定及監控使用者介面(UI)的互動,讓您全盤掌握嵌入式功能的使用情形。
當與特定應用程式相關的程式設計動作(又稱「事件」)發生時,系統會觸發應用程式回呼。此索引標籤中整理的資訊僅會顯示內嵌要求。
進一步瞭解 callback 以及在 Dropbox API 資訊主頁中設定 callback 的方法。
帳戶 Callback
「帳戶 Callback」索引標籤可協助您設定及監控伺服器事件,以便簡化工作流程並縮短延遲時間。
當發生涉及您帳戶的事件時,帳戶回呼會將事件承載傳送到您的帳戶回呼網址,以通知您的應用程式,亦即當事件中包含的所有資料都已產生時。您可以按一下下拉式選單,依日期和事件類型篩選帳戶回撥。
您可以使用帳戶 API 呼叫設定帳戶 Callback 網址,或是在「設定」頁面手動設置。
進一步瞭解 callback 以及在 Dropbox API 資訊主頁中設定 callback 的方法。
API 要求
「API 要求」索引標籤可讓您概略瞭解您送出的要求是否正常運作,讓您快速搜尋及處理任何要求錯誤。
您可以使用頁面頂端的下拉式選單,根據日期、HTTP 狀態、方法和端點篩選 API 要求。
HTTP 代碼代表您的瀏覽器與伺服器之間的互動狀態。透過 API 資訊主頁,您可以根據 HTTP 狀態代碼篩選要求,輕鬆掌握哪些要求需要留意、哪些要求依照預期正常運作。
HTTP 狀態的解讀方式如下:
- 「Informational」狀態代表伺服器尚未完成要求(代碼 100-199)。
- 「Success」狀態代表伺服器要求已成功完成,未發生錯誤(代碼 200-299)。
- 「Redirectional」狀態代表伺服器已收到要求,不過又重新導向至其他地方(代碼 300-399)。
- 「Client error」狀態代表無法存取該頁面。這是網站端的錯誤,通常發生在網頁不存在於該網站的情況(代碼 400-499)。
- 「Server error」錯誤狀態是指發出的要求有效,但是伺服器無法依照預期完成要求(代碼 500-599)。
您也可以根據方法篩選簽署要求:
- GET 適用於擷取或讀取資源。
- POST 適用於建立新資源。
- DELETE 適用於將單一資源完全刪除。
- PUT 適用於編輯整個資源。
- PATCH 適用於修改部分資源。
根據端點篩選要求的方法如下:
- 建立這個檢視畫面所需的任何要求參數(日期、HTTP 狀態、方法)。
- 按一下 [端點]。
- 按一下 [自訂]。
- 找到適用的端點,按一下旁邊的方塊。
- 按一下 [套用]。
您可以在簽署要求總覽中取得端點清單。
簽署要求使用量
簽署要求可用於參照特定要求的相關資料,包括簽署者的姓名和電子郵件地址、自訂欄位、後設資料、回應資料,以及要求建立和完成時的時間戳記。您可以根據日期和用戶端 ID 篩選使用量資料。