Introducción a la API de ingesta de datos

Con los extremos de la API de ingesta de datos, puede realizar operaciones básicas de CRUD para introducir datos en Adobe Experience Platform.

El uso de las guías de API requiere comprender bien varios servicios de Adobe Experience Platform que participan en el trabajo con datos. Antes de utilizar la API de ingesta de datos, consulte la documentación de los siguientes servicios:

• Ingesta por lotes: Permite introducir datos en Adobe Experience Platform como archivos por lotes.
• Real-time Customer Profile: Proporciona un perfil de cliente unificado en tiempo real basado en datos agregados de varias fuentes.
• Experience Data Model (XDM): El marco estandarizado mediante el cual Platform organiza los datos de experiencia del cliente.
• Sandboxes: Experience Platform proporciona entornos limitados virtuales que dividen una sola Platform instancia en entornos virtuales independientes para ayudar a desarrollar y desarrollar aplicaciones de experiencia digital.

Las secciones siguientes proporcionan información adicional que debe conocer para realizar llamadas correctamente a Profile extremos de API.

Leer llamadas de API de ejemplo

La documentación de la API de ingesta de datos proporciona llamadas de API de ejemplo para demostrar cómo dar formato correctamente a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de 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 llamadas de API de ejemplo en la guía de solución de problemas Experience Platform.

Encabezados requeridos

La documentación de la API también requiere que haya completado el tutorial de autenticación para realizar correctamente llamadas a Platform extremos. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en Experience Platform llamadas a la API, como se muestra a continuación:

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

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 específicos de cada llamada se proporcionan en los parámetros de llamada .

Todos los recursos de Experience Platform están aislados en entornos limitados virtuales específicos. Las solicitudes para las API Platform requieren un encabezado que especifique el nombre del simulador para pruebas en el que se realizará la operación:

• x-sandbox-name: {SANDBOX_NAME}

Para obtener más información sobre los entornos limitados en Platform, consulte la documentación general del entorno limitado.