Een doelaccount verwijderen met de Flow Service API
Destinations zijn pre-built integraties met bestemmingsplatforms die de naadloze activering van gegevens van Adobe Experience Platform mogelijk maken. U kunt bestemmingen gebruiken om uw bekende en onbekende gegevens te activeren voor cross-channel marketingcampagnes, e-mailcampagnes, gerichte advertenties en vele andere gebruiksscenario's.
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 API te 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 bestemmingscatalogus en volg de stappen die aan worden geschetst verbinden met de bestemming alvorens 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 te activeren voor cross-channel marketingcampagnes, e-mailcampagnes, gerichte advertenties en vele andere gebruiksscenario's.
- Sandboxen : Experience Platform verstrekt virtuele zandbakken die één enkele Experience 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 vraag in de Experience Platform het oplossen van problemengids te lezen.
Waarden verzamelen voor vereiste koppen gather-values-for-required-headers
Om vraag aan Experience Platform APIs te maken, moet u het authentificatieleerprogramma eerst 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 Experience 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 lading (POST, PUT, PATCH) bevatten vereisen een extra media typekopbal:
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 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 Experience Platform UI om bestaande dataflows te schrappen;
- Gebruik de Dienst API van de Stroom om bestaande dataflows te schrappen.
Zodra u een verbindings-id hebt en ervoor hebt gezorgd 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 verwijdering bevestigen door een opzoekverzoek (GET) in te dienen bij de verbinding. 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 Experience Platform API-foutbericht. Verwijs naar API statuscodes en de fouten van de verzoekkopbal in de het oplossen van problemengids van Experience 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 .