Introducción a las API de Adobe Experience Platform

Adobe Experience Platform se desarrolla bajo la filosofía "API First". Con las API de Platform, puede realizar mediante programación operaciones básicas de CRUD (crear, leer, actualizar, eliminar) con datos, como configurar atributos calculados, acceder a datos o entidades, exportar datos, eliminar datos o lotes innecesarios, etc.

Todas las API de cada servicio de Experience Platform comparten el mismo conjunto de encabezados de autenticación y utilizan sintaxis similares para sus operaciones de CRUD. La siguiente guía describe los pasos necesarios para empezar a utilizar las API de Platform.

Autenticación y encabezados

Para realizar llamadas correctamente a los extremos de Platform, debe completar el tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores de cada uno de los encabezados necesarios en las llamadas de API de Experience Platform, como se muestra a continuación:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Encabezado de zona protegida

Todos los recursos de Experience Platform están aislados para zonas protegidas virtuales específicas. 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:

  • x-sandbox-name: {SANDBOX_NAME}

Para obtener más información sobre las zonas protegidas en Platform, consulte la documentación de información general sobre las zonas protegidas.

Encabezado de tipo de contenido

Todas las solicitudes con una carga útil en el cuerpo de la solicitud (como llamadas de POST, PUT y PATCH) deben incluir un encabezado Content-Type. Los valores aceptados son específicos de cada extremo de API. Si se necesita un valor Content-Type específico para un extremo, su valor se mostrará en las solicitudes de API de ejemplo proporcionadas por las guías de API para servicios de Platform individuales.

Fundamentos de API de Experience Platform

Las API de Adobe Experience Platform emplean varias tecnologías y sintaxis subyacentes que son importantes de comprender para administrar de forma eficaz los recursos de Platform.

Para obtener más información sobre las tecnologías de API subyacentes que utiliza Platform, incluidos los objetos de esquema JSON de ejemplo, visite la guía Aspectos básicos de la API del Experience Platform.

Colecciones de Postman para API de Experience Platform

Postman es una plataforma de colaboración para el desarrollo de API que le permite configurar entornos con variables preestablecidas, compartir colecciones de API, optimizar solicitudes de CRUD y mucho más. La mayoría de los servicios de API de Platform tienen colecciones de Postman que se pueden utilizar para ayudar a realizar llamadas de API.

Para obtener más información acerca de Postman, incluyendo cómo configurar un entorno, una lista de colecciones disponibles y cómo importar colecciones, visite la Documentación de Platform Postman.

Lectura de llamadas de API de muestra sample-api

Los formatos de solicitud varían según la API de plataforma que se utilice. La mejor manera de aprender a estructurar las llamadas de API es siguiendo los ejemplos proporcionados en la documentación del servicio de Platform concreto que está utilizando.

La documentación de Experience Platform muestra ejemplos de llamadas de API de dos maneras diferentes. En primer lugar, la llamada se presenta en su formato de API, una representación de plantilla que muestra únicamente la operación (GET, POST, PUT, PATCH, DELETE) y el extremo que se está utilizando (por ejemplo, /global/classes). Algunas plantillas también muestran la ubicación de las variables para ilustrar cómo se debe formular una llamada, como GET /{VARIABLE}/classes/{ANOTHER_VARIABLE}.

Las llamadas se muestran como comandos cURL en una solicitud, que incluye los encabezados necesarios y la "ruta base" completa necesaria para interactuar correctamente con la API. La ruta base debe prefijarse a todos los extremos. Por ejemplo, el extremo /global/classes mencionado se convierte en https://platform.adobe.io/data/foundation/schemaregistry/global/classes. Verá el formato de la API/patrón de solicitud en toda la documentación y se espera que utilice la ruta completa que se muestra en la solicitud de ejemplo al realizar sus propias llamadas a las API de Platform.

Ejemplo de solicitud de API

A continuación se muestra un ejemplo de solicitud de API que muestra el formato que encontrará en la documentación.

Formato de API

El formato de la API muestra la operación (GET) y el punto final que se está utilizando. Las variables se indican con llaves (en este caso, {CONTAINER_ID}).

GET /{CONTAINER_ID}/classes

Solicitud

En esta solicitud de ejemplo, las variables del formato API reciben valores reales en la ruta de solicitud. Además, todos los encabezados requeridos se muestran como valores de encabezado de muestra o como variables donde se debe incluir información confidencial (como tokens de seguridad e ID de acceso).

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/global/classes \
  -H 'Accept: application/vnd.adobe.xed-id+json' \
  -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}'

Respuesta

La respuesta ilustra lo que esperaría recibir después de una llamada correcta a la API, según la solicitud enviada. En ocasiones, la respuesta se trunca en cuanto al espacio, lo que significa que puede ver más información o información adicional que la mostrada en el ejemplo.

{
    "results": [
        {
            "title": "XDM ExperienceEvent",
            "$id": "https://ns.adobe.com/xdm/context/experienceevent",
            "meta:altId": "_xdm.context.experienceevent",
            "version": "1"
        },
        {
            "title": "XDM Individual Profile",
            "$id": "https://ns.adobe.com/xdm/context/profile",
            "meta:altId": "_xdm.context.profile",
            "version": "1"
        }
    ],
    "_links": {}
}

Mensajes de error

La Guía de solución de problemas de la plataforma proporciona una lista de errores que pueden producirse al utilizar cualquier servicio de Experience Platform.

Para obtener guías de solución de problemas sobre servicios de Platform individuales, consulte el directorio de solución de problemas del servicio.

Para obtener más información sobre extremos específicos en las API de Platform, incluidos los encabezados y cuerpos de solicitud necesarios, consulte las guías de la API de Platform.

Guías de API de Platform api-guides

Guía de API
Descripción
Access Control Guía de API
El extremo de la API Access Control puede recuperar las directivas actuales en vigor para un usuario en recursos determinados dentro de una zona protegida especificada. Todas las demás capacidades de control de acceso se proporcionan a través de Adobe Admin Console.
Guía de API de ingesta por lotes
La API de Adobe Experience Platform Data Ingestion le permite introducir datos en Platform como archivos por lotes. Los datos que se están ingiriendo pueden ser los datos de perfil de un archivo plano de un sistema CRM (como un archivo de Parquet) o los datos que se ajustan a un esquema conocido en el Registro de esquemas (XDM).
Catalog Service Guía de API
La API Catalog Service permite a los desarrolladores administrar los metadatos del conjunto de datos en Adobe Experience Platform. Esto incluye ubicaciones de datos, etapas de procesamiento, errores que se produjeron durante el procesamiento e informes de datos.
Data Access Guía de API
La API Data Access permite a los desarrolladores recuperar información sobre conjuntos de datos ingeridos dentro de Experience Platform. Esto incluye el acceso y la descarga de archivos de conjuntos de datos, la recuperación de información de encabezado, la lista de lotes fallidos y exitosos y la descarga de archivos de previsualización CSV / Parquet.
Dataset Service Guía de API
La API del servicio de conjuntos de datos permite aplicar y editar etiquetas de uso para conjuntos de datos. Forma parte de las funciones del catálogo de datos de Adobe Experience Platform, pero es independiente de la API del servicio de catálogo que administra los metadatos del conjunto de datos.
Edge Network Server Guía de API
Edge Network Server API se puede usar para una variedad de casos de uso de recopilación de datos, personalización, publicidad y marketing. Server API se puede usar en servidores, IoT dispositivos, descodificadores y muchos otros dispositivos.
Identity Service Guía de API
La API Identity Service permite a los desarrolladores administrar la identificación de sus clientes en varios dispositivos, canales cruzados y casi en tiempo real mediante gráficos de identidad en Adobe Experience Platform.
Observability Insights Guía de API
Observability Insights es una API RESTful que permite a los desarrolladores exponer métricas clave de observabilidad en Adobe Experience Platform. Estas métricas proporcionan perspectivas sobre las estadísticas de uso de Platform, las comprobaciones de estado de los servicios de Platform, las tendencias históricas y los indicadores de rendimiento de varias funcionalidades de Platform.
Policy Service Guía de API
(Control de datos)
La API Policy Service le permite crear y administrar etiquetas y directivas de uso de datos para determinar qué acciones de marketing se pueden llevar a cabo con los datos que contienen determinadas etiquetas de uso de datos. Para aplicar etiquetas a conjuntos de datos y campos, consulte la guía Dataset Service API
Privacy Service Guía de API
La API Privacy Service permite a los desarrolladores crear y administrar solicitudes de clientes para acceder a sus datos personales o eliminarlos en aplicaciones de Experience Cloud, de conformidad con las normas legales de privacidad.
Query Service Guía de API
La API Query Service permite a los desarrolladores consultar sus datos de Adobe Experience Platform mediante SQL estándar.
Real-Time Customer Profile Guía de API
La API de Perfil del cliente en tiempo real permite a los desarrolladores explorar y trabajar con datos de perfil, incluida la visualización de perfiles, la creación y actualización de políticas de combinación, la exportación o el muestreo de datos de perfil y la eliminación de datos de perfil que ya no son necesarios o que se añadieron por error.
Guía de API de espacio aislado
La API de espacio aislado permite a los desarrolladores administrar mediante programación entornos de espacio aislado virtuales en Adobe Experience Platform.
Schema Registry Guía de API
(XDM)
La API Schema Registry permite a los desarrolladores administrar mediante programación todos los esquemas y los recursos del Modelo de datos de experiencia (XDM) relacionados dentro de Adobe Experience Platform.
Segmentation Service Guía de API
La API Segmentation Service permite a los desarrolladores administrar mediante programación las operaciones de segmentación en Adobe Experience Platform. Esto incluye la generación de segmentos y audiencias a partir de los datos del perfil del cliente en tiempo real.
Sensei Machine Learning Guía de API
(Data Science Workspace)
La API Sensei Machine Learning proporciona un mecanismo para que los científicos de datos organicen y administren los servicios de aprendizaje automático (ML) desde la incorporación del algoritmo, la experimentación y la implementación de servicios.

Para obtener más información sobre los extremos específicos y las operaciones disponibles para cada servicio, consulte la documentación de referencia de la API en Adobe I/O.

Pasos siguientes

Este documento introdujo los encabezados necesarios, las guías disponibles y proporcionó un ejemplo de llamada de API. Ahora que tiene los valores de encabezado necesarios para realizar llamadas de API en Adobe Experience Platform, seleccione un extremo de API que desee explorar en la tabla de guías de API de Platform.

Para obtener respuestas a las preguntas más frecuentes, consulte la Guía de solución de problemas de la plataforma.

Para configurar un entorno de Postman y explorar las colecciones de Postman disponibles, consulte la Guía de Platform Postman.

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5