Documentation Experience Platform Présentation d’Experience Platform

Point d’entrée des événements d’audit

Last update: Wed Aug 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Audits
API

Créé pour :

Développeur

Les journaux d’audit sont utilisés pour fournir des détails sur l’activité des utilisateurs pour divers services et fonctionnalités. 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. Le point d’entrée /audit/events de l’API Audit Query vous permet de récupérer par programmation les données d’événement pour l’activité de votre organisation dans Experience Platform.

Prise en main

Le point d’entrée dʼAPI utilisé dans ce guide fait partie de lʼ Audit Query API. Avant de continuer, consultez le guide de prise en main pour obtenir des liens vers la documentation associée, un guide de lecture des exemples dʼappels API dans ce document et des informations importantes sur les en-têtes requis pour réussir des appels à nʼimporte quel API dʼExperience Platform.

Liste des événements d’audit

Vous pouvez récupérer les données d’événement en adressant une requête GET au point d’entrée /audit/events, en spécifiant les événements que vous souhaitez récupérer dans la payload.

Format d’API

GET /audit/events

L’API Audit Query prend en charge l’utilisation de paramètres de requête pour paginer et filtrer les résultats lors de l’énumération d’événements.

Paramètre

Description

limit

Nombre maximal d’enregistrements à renvoyer dans la réponse. La limit par défaut est de 50.

start

Pointeur vers le premier élément pour les résultats de recherche renvoyés. Pour accéder à la page de résultats suivante, ce paramètre doit être incrémenté de la même quantité que celle indiquée par « limit ». Exemple : pour accéder à la page de résultats suivante pour une requête avec une limite=50, utilisez le paramètre start=50, puis start=100 pour la page suivante, et ainsi de suite.

queryId

Lors de l’exécution d’une requête au point d’entrée /audit/events, la réponse inclut une propriété de chaîne queryId. Pour effectuer la même requête dans un appel distinct, vous pouvez inclure la valeur de l’identifiant en tant que paramètre de requête unique au lieu de configurer à nouveau manuellement les paramètres de recherche.

Requête

curl -X POST \
  https://platform.adobe.io/data/foundation/audit/events?limit=10
  -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}' \
  -H 'x-request-id: {TRACING_ID}' \

Réponse

Une réponse réussie renvoie les points de données obtenus pour les mesures et les filtres spécifiés dans la requête.

{
  "_embedded": {
    "events": [
      {
        "id": "6ecc125d-da03-4882-a944-88c707ddc3f7",
        "requestId": "5YGdpTX5PvRrdqCfrCT8p8lWphZPzxl8",
        "permissionResource": "Dataset",
        "permissionType": "WRITE",
        "assetType": "Dataset",
        "action": "Create",
        "status": "Allow",
        "failureCode": "",
        "timestamp": "2025-06-24T16:50:28.318+0000",
        "version": "1.0",
        "imsOrgId": "{ORGANIZATION_ID}",
        "region": "VA7",
        "authId": "e6b46821-e2b4-4729-952f-2e4afd713b31",
        "assetId": "685ad754fb1abe2b263df4b3",
        "assetName": "my-dataset",
        "sandboxName": "prod",
        "sandboxId": "{SANDBOX_ID}",
        "userEmail": "{USER_EMAIL}",
        "userIpAddresses": [
          "130.*.*.*",
          "10.*.*.*"
        ],
        "enhancedEvents": [
          {
            "id": "0ee91e42-ac46-4f35-a01a-f74a1569c404",
            "requestId": "5YGdpTX5PvRrdqCfrCT8p8lWphZPzxl8",
            "permissionResource": "Dataset",
            "permissionType": "Write",
            "assetType": "Dataset",
            "action": "Create",
            "status": "Success",
            "failureCode": "",
            "timestamp": "2025-06-24T16:50:28.883+0000",
            "assetId": "685ad754fb1abe2b263df4b3",
            "assetName": "my-dataset"
          }
        ]
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://platform.adobe.io/data/foundation/audit/events?property=user%253D%253Ddraghici%2540adobe.com"
    },
    "page": {
      "href": "https://platform.adobe.io/data/foundation/audit/events?queryId=b3JkZXJCeVJ1bGVzPSZwcm9wZXJ0eT11c2VyPT1kcmFnaGljaUBhZG9iZS5jb20mdGltZXN0YW1wSW5kZXg9MTc1MDc4MzgyODMxOCZ0b3RhbEVsZW1lbnRzPTE3&limit=50{&start}",
      "templated": true
    }
  },
  "page": {
    "size": 1,
    "totalElements": 1,
    "totalPages": 1,
    "number": 1
  },
  "queryId": "b3JkZXJCeVJ1bGVzPSZwcm9wZXJ0eT11c2VyPT1kcmFnaGljaUBhZG9iZS5jb20mdGltZXN0YW1wSW5kZXg9MTc1MDc4MzgyODMxOCZ0b3RhbEVsZW1lbnRzPTE3"
}

Propriété

Description

events

Tableau dont les objets représentent chacun des événements spécifiés dans la requête. Chaque objet contient des informations sur la configuration du filtre et les données d’événement renvoyées.

userEmail

Adresse électronique de l’utilisateur qui a exécuté l’événement.

eventType

Type d’événement. Les types d’événements incluent les Core et les Enhanced.

imsOrgId

L’identifiant de l’organisation sous laquelle l’événement a eu lieu.

permissionResource

Le produit ou la fonctionnalité qui a fourni l’autorisation effectue l’action. Une ressource peut être l’une des suivantes :

Activation
ActivationAssociation
AnalyticSource
AudienceManagerSource
BizibleSource
CustomerAttributeSource
Dataset
EnterpriseSource
LaunchSource
MarketoSource
ProductProfile
ProfileConfig
Sandbox
Schema
Segment
StreamingSource

permissionType

Type d’autorisation impliqué dans l’action.

assetType

Type de ressource Experience Platform sur laquelle l’action a été effectuée.

assetId

Identifiant unique de la ressource Experience Platform sur laquelle l’action a été effectuée.

assetName

Nom de la ressource Experience Platform sur laquelle l’action a été effectuée.

action

Type d’action qui a été enregistré pour l’événement. Une action peut être l’une des suivantes :

Add
Create
Dataset activate
Dataset remove
Delete
Disable for profile
Enable
Enable for profile
Profile activate
Profile remove
remove
reset
segment activate
segment remove
update

status

Statut de l’action. Un statut peut être l’un des suivants :

Allow
Deny
Failure
Success

recommendation-more-help

5741548a-2e07-44b3-9157-9c181502d0c5