Suppression d’un compte de destination à l’aide de l’API Flow Service
Les Destinations sont des intégrations préconfigurées à des plateformes de destination qui permettent d’activer facilement des données provenant d’Adobe Experience Platform. Vous pouvez utiliser les destinations pour activer vos données connues et inconnues pour les campagnes marketing cross-canal, les campagnes par e-mail, la publicité ciblée et de nombreux autres cas d’utilisation.
Avant d’activer les données, vous devez vous connecter à la destination en configurant d’abord un compte de destination. Ce tutoriel décrit les étapes à suivre pour supprimer les comptes de destination qui ne sont plus nécessaires à l’aide de l’ Flow Service API.
Prise en main get-started
Ce tutoriel nécessite que vous disposiez d’un identifiant de connexion valide. L’identifiant de connexion représente la connexion du compte à la destination. Si vous ne disposez pas d’un ID de connexion valide, sélectionnez votre destination de votre choix dans le catalogue des destinations et suivez les étapes décrites à se connecter à la destination avant de lancer ce tutoriel.
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
- Destinations : Destinations sont des intégrations préconfigurées avec des plateformes de destination qui permettent l’activation transparente des données de Adobe Experience Platform. Vous pouvez utiliser les destinations pour activer vos données connues et inconnues pour les campagnes marketing cross-canal, les campagnes par e-mail, la publicité ciblée et de nombreux autres cas d’utilisation.
- Sandbox : Experience Platform fournit des sandbox virtuels qui divisent une instance Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Les sections suivantes apportent des informations supplémentaires dont vous aurez besoin pour supprimer un compte de destination à l’aide de l’API Flow Service.
Lecture d’exemples d’appels API reading-sample-api-calls
Ce tutoriel fournit des exemples d’appels API pour démontrer comment formater vos requêtes. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels d’API, voir la section concernant la lecture d’exemples d’appels d’API dans le guide de dépannage Experience Platform.
Collecte des valeurs des en-têtes requis gather-values-for-required-headers
Pour lancer des appels aux API Platform, vous devez d’abord suivre le tutoriel d’authentification. Le tutoriel d’authentification fournit les valeurs de chacun des en-têtes requis dans tous les appels d’API Experience Platform, comme indiqué ci-dessous :
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Toutes les ressources qui se trouvent dans Experience Platform, y compris celles liées à la Flow Service, sont isolées dans des sandbox virtuels spécifiques. Toutes les requêtes envoyées aux API Platform nécessitent un en-tête spécifiant le nom du sandbox dans lequel l’opération sera effectuée :
x-sandbox-name: {SANDBOX_NAME}
x-sandbox-name n’est pas spécifié, les requêtes sont résolues sous l’environnement de test prod.Toutes les requêtes qui contiennent un payload (POST, PUT, PATCH) nécessitent un en-tête de type de média supplémentaire :
Content-Type: application/json
Recherchez l’identifiant de connexion du compte de destination que vous souhaitez supprimer. find-connection-id
La première étape de la suppression d’un compte de destination consiste à trouver l’identifiant de connexion correspondant au compte de destination que vous souhaitez supprimer.
Dans l’interface utilisateur de l’Experience Platform, accédez à Destinations > Comptes et sélectionnez le compte à supprimer en sélectionnant le numéro dans la colonne Destinations.
Vous pouvez ensuite récupérer l’identifiant de connexion du compte de destination à partir de l’URL de votre navigateur.
Supprimer la connexion delete-connection
Pour supprimer des flux de données existants, reportez-vous aux pages ci-dessous :
- Utilisez l’interface utilisateur de l’Experience Platform pour supprimer les flux de données existants ;
- Utilisez l’API Flow Service pour supprimer les flux de données existants.
Une fois que vous disposez d’un identifiant de connexion et que vous avez vérifié qu’il n’existe aucun flux de données vers le compte de destination, effectuez une requête de DELETE vers l’API Flow Service.
Format d’API
DELETE /connections/{CONNECTION_ID}
{CONNECTION_ID}id unique de la connexion que vous souhaitez supprimer.Requête
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}'
Réponse
Une réponse réussie renvoie un état HTTP 204 (pas de contenu) et un corps vide. Vous pouvez confirmer la suppression en tentant d’adresser une requête de recherche (GET) à la connexion. L’API renvoie une erreur HTTP 404 (Introuvable), indiquant que le compte de destination a été supprimé.
Gestion des erreurs d’API api-error-handling
Les points de terminaison d’API de ce tutoriel suivent les principes généraux des messages d’erreur de l’API d’Experience Platform. Consultez les sections Codes dʼétat d’API et Erreurs dʼen-tête de requête dans le guide de dépannage de Platform.
Étapes suivantes
En suivant ce tutoriel, vous avez réussi à utiliser l’API Flow Service pour supprimer des comptes de destination existants. Pour plus d’informations sur l’utilisation des destinations, consultez la présentation des destinations.