Fedex Logo

如何將追蹤號碼新增至 Webhook

若要使用 Advanced Integrated Visibility Tracking Number Subscription API 將追蹤號碼新增到您的 Webhook 訂閱,請進行以下步驟:

  1. 透過前一節提供的步驟建立 Advanced Integrated Visibility 追蹤號碼訂閱專案,也可以使用「開始使用指南」中提供的步驟。
  2. 您需要 OAuth 權杖才能啟動 Advanced Integrated Visibility Tracking Number Subscription API 呼叫。若要產生 OAuth 權杖,請使用 Authorization API。請參考 API 目錄中的 Authorization API 文件,瞭解產生 OAuth 權杖的詳細步驟。
  3. 按一下左側導覽選單中的「專案詳細資料」選項。在「生產金鑰」索引標籤底下,向下捲動尋找 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 端點

此端點讓您能夠取得所有處理中工作目前的摘要。

 

  1. 使用步驟 2 產生的 OAuth 權杖搭配 Track Number Association 端點,將追蹤號碼新增至您的 Webhook 訂閱。

 

驗證規則:

  • 「Webhook 名稱」應為專屬欄位。
  • Webhook 目的地 URL 必須使用標準化語法格式。
  • 所有用於建立 Webhook 的必填欄位皆不得空白。
  • 您應至少與一個可用的 FedEx 託運帳號建立關聯,才可建立 Webhook。
  • 成功的驗證:
    • 當 Webhook 成功建立後,客戶將會收到確認訊息。

      範例確認訊息:<<Webhook 名稱>> 已成功建立。變更可能需要 10 分鐘才會生效。

  • 未成功/失敗的驗證:
    • 如果 FedEx 收到 200 (確定) 或 202 (已接受) 以外的任何回應,則 Webhook 目的地 URL 的驗證將會視為失敗。
CLOSE

Response

Copy