Een doelaccount verwijderen met de Flow Service API
Destinations zijn vooraf gebouwde integratie met bestemmingsplatforms die voor de naadloze activering van gegevens van Adobe Experience Platform toestaan. U kunt bestemmingen gebruiken om uw bekende en onbekende gegevens voor kanaalmarketing campagnes, e-mailcampagnes, gerichte reclame, en vele andere gebruiksgevallen te activeren.
Voordat u gegevens kunt activeren, moet u verbinding maken met de bestemming door eerst een doelaccount in te stellen. Dit leerprogramma behandelt de stappen om bestemmingsrekeningen te schrappen die niet meer nodig zijn door Flow Service APIte gebruiken.
Aan de slag get-started
Voor deze zelfstudie moet u een geldige verbinding-id hebben. De verbindings-id vertegenwoordigt de accountverbinding met de bestemming. Als u geen geldige verbindingsidentiteitskaart hebt, selecteer uw bestemming van keus van de bestemmingscatalogusen volg de stappen die aan worden geschetst verbinden met de bestemmingalvorens dit leerprogramma te proberen.
Voor deze zelfstudie hebt u ook een goed inzicht nodig in de volgende onderdelen van Adobe Experience Platform:
- Doelen: Destinations zijn pre-gebouwde integratie met bestemmingsplatforms die voor de naadloze activering van gegevens van Adobe Experience Platform toestaan. U kunt bestemmingen gebruiken om uw bekende en onbekende gegevens voor kanaalmarketing campagnes, e-mailcampagnes, gerichte reclame, en vele andere gebruiksgevallen te activeren.
- Sandboxen: Experience Platform verstrekt virtuele zandbakken die één enkele Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.
De volgende secties bevatten aanvullende informatie die u moet weten om een doelaccount met de Flow Service API te kunnen verwijderen.
API-voorbeeldaanroepen lezen reading-sample-api-calls
Deze zelfstudie biedt voorbeeld-API-aanroepen om aan te tonen hoe uw verzoeken moeten worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op hoe te om voorbeeld API vraagin de Experience Platform het oplossen van problemengids te lezen.
Waarden verzamelen voor vereiste koppen gather-values-for-required-headers
Om vraag aan Platform APIs te maken, moet u het authentificatieleerprogrammaeerst voltooien. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in alle API-aanroepen van Experience Platform , zoals hieronder wordt getoond:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alle bronnen in Experience Platform, inclusief bronnen die tot Flow Service behoren, zijn geïsoleerd naar specifieke virtuele sandboxen. Alle aanvragen naar Platform API's vereisen een header die de naam van de sandbox opgeeft waarin de bewerking plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
x-sandbox-name niet is opgegeven, worden aanvragen opgelost onder de sandbox prod .Alle verzoeken die een nuttige lading (POST, PUT, PATCH) bevatten vereisen een extra media type kopbal:
Content-Type: application/json
De verbinding-id zoeken van de doelaccount die u wilt verwijderen find-connection-id
De eerste stap bij het verwijderen van een doelaccount is om de verbinding-id te achterhalen die overeenkomt met de doelaccount die u wilt verwijderen.
Blader in de gebruikersinterface van het Experience Platform naar Destinations > Accounts en selecteer de account die u wilt verwijderen door het nummer in de kolom Destinations te selecteren.
Vervolgens kunt u de verbinding-id van het doelaccount ophalen via de URL in uw browser.
Verbinding verwijderen delete-connection
Als u bestaande gegevensstromen wilt verwijderen, raadpleegt u de volgende pagina's:
- gebruik het Experience Platform UIom bestaande dataflows te schrappen;
- Gebruik de Dienst API van de Stroomom bestaande dataflows te schrappen.
Nadat u een verbinding-id hebt en hebt gecontroleerd dat er geen gegevensstromen naar de doelaccount bestaan, voert u een DELETE-aanvraag uit naar de Flow Service API.
API formaat
DELETE /connections/{CONNECTION_ID}
{CONNECTION_ID}id -waarde voor de verbinding die u wilt verwijderen.Verzoek
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}'
Reactie
Een geslaagde reactie retourneert HTTP-status 204 (Geen inhoud) en een lege hoofdtekst. U kunt de schrapping bevestigen door een raadpleging (GET) verzoek aan de verbinding te proberen. De API retourneert een HTTP 404 (Not Found)-fout die aangeeft dat de doelaccount is verwijderd.
API-foutafhandeling api-error-handling
De API-eindpunten in deze zelfstudie volgen de algemene beginselen van het API-foutbericht voor Experience Platforms. Verwijs naar API statuscodesen de fouten van de verzoekkopbalin de het oplossen van problemengids van het Platform.
Volgende stappen
Door deze zelfstudie te volgen, hebt u de Flow Service API gebruikt om bestaande doelaccounts te verwijderen. Voor meer informatie bij het gebruiken van bestemmingen, verwijs naar het overzicht van bestemmingen.