Introducción a la API de ingesta de datos

Mediante 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 la API requiere una comprensión práctica de varios servicios de Adobe Experience Platform implicados en el trabajo con datos. Antes de usar la API de ingesta de datos, revise 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 en función de los 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 zonas protegidas virtuales que dividen una sola Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.

Las secciones siguientes proporcionan información adicional que deberá conocer para poder realizar llamadas correctamente a Profile Extremos de API.

Leer llamadas de API de muestra

La documentación de la API de ingesta de datos proporciona ejemplos de llamadas a la API para demostrar cómo dar formato adecuado 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 API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en el Experience Platform guía de solución de problemas.

Encabezados obligatorios

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

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

Todas las solicitudes con una carga útil en el cuerpo de la solicitud (como llamadas de POST, PUT y PATCH) deben incluir un Content-Type encabezado. Los valores aceptados específicos de cada llamada se proporcionan en los parámetros de llamada.

Todos los recursos de Experience Platform están aisladas para zonas protegidas virtuales específicas. Solicitudes a Platform Las API 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 general de zona protegida.