如要使用「進階集成可見性查詢號碼訂閱API」，將查詢號碼新增至您的webhook訂閱中，請依照下列步驟操作：

1. 依照上述步驟建立「進階集成可見性查詢號碼訂閱」項目，或依照入門指南中提供的步驟操作。
2. 您需要以OAUTH令牌來發起「進階集成可見性查詢號碼訂閱API」呼叫。如要產生OAUTH令牌，請使用授權API。請參閱API目錄中的授權API說明文件，以了解產生OAUTH令牌的詳細步驟。
3. 點擊左側導航選單中的「項目詳情」。在「正式版金鑰」索引標籤中，向下捲動以尋找「進階集成可見性查詢號碼訂閱API」說明文件。

打開「進階集成可見性查詢號碼訂閱API」說明文件後，您將看到三個端點：

查詢號碼關聯端點

• 使用此端點，在指定的Webhook訂閱中新增或移除查詢號碼。詳情請參閱「進階集成可見性查詢號碼訂閱API」說明文件。
• 查詢號碼的任何新增或移除操作，均為非同步作業。系統將傳送作業ID，以回應新增或移除查詢號碼關聯API調用。

查詢號碼作業詳情端點

此端點提供了有關指定作業ID的詳情，譬如在全部已提交的查詢號碼當做，有多少個已成功新增至指定的Webhook訂閱，或有多少個仍在處理中。

查詢號碼作業狀態端點

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

1. 使用第2步產生的AUTH令牌和查詢號碼關聯端點，將查詢號碼新增至您的Webhook訂閱。

驗證規則：

• Webhook 名稱應為唯一。
• Webhook 目的地網址必須為標準化句法格式。
• 建立 Webhook 的所有必填欄位均不得為空。
• 應至少與一個可用的 FedEx 託運帳號相關聯，以用於建立 Webhook。
• 驗證成功：
  • 成功建立 Webhook 後，顧客將會收到一則確認訊息。

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

• 驗證不成功／失敗：
  • 如果 FedEx 收到任何 200 (確定) 或 202 (已接受) 以外的回應，Webhook 目的地網址驗證將視同失敗。