Prise en main de l’API de requête d’audit

Adobe Experience Platform vous permet de contrôler l’activité des utilisateurs pour divers services et fonctionnalités sous la forme de journaux d’événements de contrôle. Chaque action enregistrée dans un journal contient des métadonnées qui indiquent le type d’action, la date et l’heure, l’ID d’e-mail de l’utilisateur ou de l’utilisatrice qui a exécuté l’action et des attributs supplémentaires liés au type d’action.

L’API de requête d’audit vous permet de contrôler l’activité des utilisateurs pour divers services et fonctionnalités sous la forme de journaux d’événements d’audit. Ce document présente les concepts de base que vous devez connaître avant de lancer des appels à l’API de requête d’audit.

Conditions préalables

Pour gérer les événements de contrôle, vous devez disposer de la variable Afficher le journal d’activité utilisateur l’autorisation de contrôle d’accès accordée (trouvée sous Gouvernance des données catégorie). Pour savoir comment gérer les autorisations individuelles pour les fonctionnalités de Platform, reportez-vous à la section documentation sur le contrôle d’accès.

Lecture d’exemples d’appels API

Ce guide 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 pour les exemples d’appels API dans la documentation, consultez la section sur la lecture d’exemples d’appels API dans le guide de dépannage d’Experience Platform.

Collecte des valeurs des en-têtes requis

Ce guide nécessite que vous ayez suivi le tutoriel sur l’authentification afin d’effectuer des appels aux API de Platform avec succès. Le tutoriel sur l’authentification indique les valeurs de chacun des en-têtes requis dans tous les appels API Experience Platform, comme illustré ci-dessous :

Dans Experience Platform, toutes les ressources sont isolées dans des sandbox virtuels spécifiques. Toutes les requêtes envoyées à Platform Les API requièrent un en-tête qui spécifie le nom de l’environnement de test dans lequel l’opération aura lieu. Pour plus d’informations sur les sandbox dans Platform, consultez la documentation de présentation des sandbox.

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

Étapes suivantes

Pour commencer à lancer des appels à l’aide de la variable Audit Query API, reportez-vous à la section guide de point de fin des événements et le guide de point de fin d’exportation.