使用流服務API刪除目標資料流

您可以使用 Flow Service API

本教程介紹使用以下步驟將資料流刪除到批處理和流式處理目標 Flow Service。

快速入門

本教程要求您具有有效的流ID。 如果沒有有效的流ID,請從 目標目錄 並按照 連接到目標激活資料 在嘗試本教程之前。

本教程還要求您對以下Adobe Experience Platform元件有一定的瞭解:

  • 目標: Destinations 是預先構建的與目標平台的整合,允許無縫激活來自Adobe Experience Platform的資料。 您可以使用目標來激活跨渠道市場營銷活動、電子郵件活動、目標廣告和許多其他使用案例的已知和未知資料。
  • 沙箱: Experience Platform 提供虛擬沙箱,將單個沙箱 Platform 實例到獨立的虛擬環境,以幫助開發和發展數字型驗應用程式。

以下各節提供了需要瞭解的其他資訊,以便使用 Flow Service API。

讀取示例API調用

本教程提供了示例API調用,以演示如何格式化請求。 這些包括路徑、必需的標頭和正確格式化的請求負載。 還提供了API響應中返回的示例JSON。 有關示例API調用文檔中使用的約定的資訊,請參見上的 如何讀取示例API調用 的 Experience Platform 疑難解答指南。

收集所需標題的值

為了呼叫 Platform API,必須首先完成 驗證教程。 完成身份驗證教程將提供所有中每個必需標頭的值 Experience Platform API調用,如下所示:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

中的所有資源 Experience Platform包括那些 Flow Service,與特定虛擬沙箱隔離。 所有請求 Platform API需要一個標頭,該標頭指定操作將在以下位置進行的沙盒的名稱:

  • x-sandbox-name: {SANDBOX_NAME}
注意

如果 x-sandbox-name 未指定標頭,請求在 prod 沙盒。

所有包含負載(POST、PUT、PATCH)的請求都需要附加的媒體類型報頭:

  • Content-Type: application/json

刪除目標資料流

使用現有流ID,可以通過執行DELETE請求刪除目標資料流 Flow Service API。

API格式

DELETE /flows/{FLOW_ID}
參數 說明
{FLOW_ID} 獨特 id 要刪除的目標資料流的值。

要求

curl -X DELETE \
    'https://platform.adobe.io/data/foundation/flowservice/flows/455fa81b-f290-4222-94b6-540a73e3fbc2' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {ORG_ID}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的響應返回HTTP狀態202(無內容)和空白正文。 您可以通過嘗試對資料流進行查找(GET)請求來確認刪除。 API將返回HTTP 404(未找到)錯誤,表示資料流已被刪除。

API錯誤處理

本教程中的API端點遵循一般Experience PlatformAPI錯誤消息原則。 請參閱 API狀態代碼請求標頭錯誤 有關解釋錯誤響應的詳細資訊,請參閱「Platform troubleshooting guide(平台故障排除指南)」。

後續步驟

按照本教程,您已成功使用 Flow Service 將現有資料流刪除到目標的API。

有關如何使用用戶介面執行這些操作的步驟,請參閱上的教程 刪除UI中的資料流

你現在可以繼續 刪除目標帳戶 使用 Flow Service API。

本頁內容