Guide de l’API Data Hygiene

L’API Data Hygiene vous permet de corriger ou de supprimer par programmation les données personnelles des clients stockées dans Adobe Experience Platform, ainsi que de planifier des dates d’expiration pour les jeux de données. Ce guide décrit les étapes préalables requises pour utiliser l’API et contient des liens vers une documentation plus spécifique aux points d’entrée.

Prise en main

Vous pouvez accéder à l’API Data Hygiene via le chemin racine suivant : https://platform.adobe.io/data/core/hygiene/.

Les sections ci-dessous présentent les concepts de base que vous devez connaître avant d’effectuer des appels à l’API.

Collecte des valeurs des en-têtes requis

Pour effectuer des appels à l’API Data Hygiene, vous devez d’abord rassembler vos informations d’authentification. Suivez le Guide d’authentification des API afin de générer des valeurs pour chacun des en-têtes obligatoires pour l’API Data Hygiene, comme illustré ci-dessous :

Toutes les requêtes contenant un payload (POST, PUT, PATCH) requièrent un en-tête supplémentaire :

Lecture d’exemples d’appels API

Ce document fournit un exemple d’appel API pour illustrer la manière dont vous devez formater vos requêtes. Pour en savoir plus sur les conventions utilisées dans la documentation pour les exemples d’appels API, consultez la section relative à la lecture d’exemples d’appels API dans le guide de prise en main des API d’Experience Platform.

Expirations de jeux de données

Une expiration de jeu de données correspond à une action « supprimer un jeu de données » différée. En créant une expiration de jeu de données, vous spécifiez une heure ultérieure à laquelle ce jeu de données doit être supprimé. Consultez le Guide de point d’entrée d’expiration de jeux de données pour plus d’informations sur la planification des expirations de jeux de données dans l’API.

Suppressions d’enregistrements

L’API Data Hygiene vous permet de supprimer tous les enregistrements associés à une identité dans un ou tous les jeux de données. Toutes les tâches du cycle de vie des données qui suppriment les identités sont représentées par un concept appelé ordre de travail. Voir guide de point de terminaison des commandes de travail pour plus d’informations sur l’utilisation des suppressions d’enregistrement dans l’API.

Quota

Votre entreprise est limitée à un quota mensuel de tâches prédéterminé pour chaque type d’opération de cycle de vie des données, qui peut varier en fonction des licences. Voir Guide du point de fin de quota pour plus d’informations sur l’affichage de l’état actuel du quota de vos processus de cycle de vie des données.

Étapes suivantes

Ce guide explique comment gérer les demandes du cycle de vie des données à l’aide d’appels API. Pour plus d’informations sur l’exécution de ces actions dans l’interface utilisateur de Platform, voir guide de l’interface utilisateur du cycle de vie des données.