如何將追蹤號碼新增至 Webhook
若要使用 Advanced Integrated Visibility Tracking Number Subscription API 將追蹤號碼新增到您的 Webhook 訂閱,請進行以下步驟:
- 透過前一節提供的步驟建立 Advanced Integrated Visibility 追蹤號碼訂閱專案,也可以使用「開始使用指南」中提供的步驟。
- 您需要 OAuth 權杖才能啟動 Advanced Integrated Visibility Tracking Number Subscription API 呼叫。若要產生 OAuth 權杖,請使用 Authorization API。請參考 API 目錄中的 Authorization API 文件,瞭解產生 OAuth 權杖的詳細步驟。
- 按一下左側導覽選單中的「專案詳細資料」選項。在「生產金鑰」索引標籤底下,向下捲動尋找 Advanced Integrated Visibility Tracking Number Subscription API 文件。
您找到 Advanced Integrated Visibility Tracking Number Subscription API 文件時,會找到三個端點:
Track Number Association 端點
- 使用此端點可為特定的 Advanced Integrated Visibility 訂閱新增或移除追蹤號碼。請在 Advanced Integrated Visibility Tracking Number Subscription API 文件中找到更多詳細資料。
- 新增或移除追蹤號碼為非同步工作。新增或移除追蹤號碼關聯 API 呼叫會傳送工作識別碼作為回應。
Track Number Job Details 端點
此端點會針對特定的工作識別碼提供詳細資料,例如在所有已送出的追蹤號碼中,有多少已成功新增至特定的 Webhook 訂閱,或有多少仍在處理中。
Track Number Job Status 端點
此端點讓您能夠取得所有處理中工作目前的摘要。
- 使用步驟 2 產生的 OAuth 權杖搭配 Track Number Association 端點,將追蹤號碼新增至您的 Webhook 訂閱。
驗證規則:
- 「Webhook 名稱」應為專屬欄位。
- Webhook 目的地 URL 必須使用標準化語法格式。
- 所有用於建立 Webhook 的必填欄位皆不得空白。
- 您應至少與一個可用的 FedEx 託運帳號建立關聯,才可建立 Webhook。
- 成功的驗證:
- 當 Webhook 成功建立後,客戶將會收到確認訊息。
範例確認訊息:<<Webhook 名稱>> 已成功建立。變更可能需要 10 分鐘才會生效。
- 當 Webhook 成功建立後,客戶將會收到確認訊息。
- 未成功/失敗的驗證:
- 如果 FedEx 收到 200 (確定) 或 202 (已接受) 以外的任何回應,則 Webhook 目的地 URL 的驗證將會視為失敗。
Response