Introducción a la API de consulta de auditoría

Adobe Experience Platform permite auditar la actividad del usuario para varios servicios y funcionalidades en forma de registros de eventos de auditoría. Cada acción registrada contiene metadatos que indican el tipo de acción, la fecha y la hora, el ID de correo electrónico del usuario que realizó la acción y los atributos adicionales relevantes de ese tipo de acción.

La API de consulta de auditoría le permite auditar la actividad del usuario para varios servicios y funcionalidades en forma de registros de eventos de auditoría. Este documento proporciona una introducción a los conceptos principales que necesita conocer antes de intentar realizar llamadas a la API de consulta de auditoría.

Requisitos previos

Para administrar eventos de auditoría, debe contar con el permiso de control de acceso Ver registro de actividad de usuario concedido (que se encuentra en la categoría Control de datos). Para obtener información sobre cómo administrar permisos individuales para las características de Platform, consulte la documentación de control de acceso.

Lectura de llamadas de API de muestra

Esta guía proporciona ejemplos de llamadas de API para mostrar cómo dar formato a las solicitudes. Estas incluyen rutas, encabezados obligatorios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de la API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer las llamadas de API de ejemplo en la guía de solución de problemas del Experience Platform.

Recopilación de valores para los encabezados obligatorios

Esta guía requiere que haya completado el tutorial de autenticación para realizar correctamente llamadas a las API de Platform. Al completar el tutorial de autenticación, se proporcionan los valores de cada uno de los encabezados necesarios en todas las llamadas a la API de Experience Platform, como se muestra a continuación:

Todos los recursos de Experience Platform están aislados en zonas protegidas virtuales específicas. Todas las solicitudes a las API de Platform requieren un encabezado que especifique el nombre de la zona protegida en la que se realizará la operación. Para obtener más información sobre las zonas protegidas en Platform, consulte la documentación de información general sobre las zonas protegidas.

Todas las solicitudes que contienen una carga útil (POST, PUT y PATCH) requieren un encabezado adicional:

Pasos siguientes

Para empezar a realizar llamadas mediante la API Audit Query, consulte la guía de extremo de eventos y la guía de extremo de exportación.