使用流程服務API刪除目的地帳戶
Destinations 是預先建立的和目標平台的整合，可讓來自 Adobe Experience Platform 的資料順暢啟動。您可使用目的地啟用已知和未知的資料，以進行跨通路行銷活動、電子郵件行銷活動、設定目標的廣告活動和其他諸多使用案例。
在啟用資料之前，您必須先設定目的地帳戶，以連線至目的地。 本教學課程涵蓋使用Flow Service API刪除不再需要的目的地帳戶的步驟。
快速入門 get-started
本教學課程要求您具備有效的連線ID。 連線ID代表與目的地的帳戶連線。 如果您沒有有效的連線ID，請從目的地目錄中選取您選擇的目的地，然後依照概述的步驟連線至目的地，再嘗試進行此教學課程。
本教學課程也要求您實際瞭解下列Adobe Experience Platform元件：
下列章節提供您需瞭解的其他資訊，才能使用Flow Service API成功刪除目的地帳戶。
讀取範例 API 呼叫 reading-sample-api-calls
本教學課程提供範例API呼叫，示範如何格式化您的請求。 這些包括路徑、必要的標頭和正確格式化的請求承載。 此外，也提供 API 回應中傳回的範例 JSON。 如需檔案中所使用範例API呼叫慣例的詳細資訊，請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。
收集所需標頭的值 gather-values-for-required-headers
若要呼叫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 find-connection-id
刪除目的地帳戶的第一步，是找出與您要刪除的目的地帳戶對應的連線ID。
在Experience PlatformUI中，瀏覽至 目的地 > 帳戶，並選取 目的地 欄中的數字，以選取您要刪除的帳戶。
接著，您可以從瀏覽器的URL擷取目的地帳戶的連線ID。
刪除連線 delete-connection
若要刪除現有的資料流，請參閱以下頁面：
- 使用Experience PlatformUI刪除現有的資料流；
- 使用流程服務API刪除現有的資料流。
當您有連線ID並已確定目的地帳戶不存在任何資料流後，請對Flow Service API執行DELETE要求。
API格式
DELETE /connections/{CONNECTION_ID}
{CONNECTION_ID}id值。要求
curl -X DELETE \
'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
-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狀態204 （無內容）和空白內文。 您可以嘗試對連線進行查詢(GET)來確認刪除。 此API將傳回HTTP 404 （找不到）錯誤，這表示已刪除目的地帳戶。
API錯誤處理 api-error-handling
本教學課程中的API端點會遵循一般Experience PlatformAPI錯誤訊息原則。 請參閱Platform疑難排解指南中的API狀態碼和請求標頭錯誤。
後續步驟
依照此教學課程，您已成功使用Flow Service API刪除現有的目的地帳戶。 如需使用目的地的詳細資訊，請參閱目的地概觀。