Introducción a la API Real-Time Customer Profile getting-started
Con los extremos de la API del perfil del cliente en tiempo real, puede realizar operaciones básicas de CRUD con datos de perfil, como configurar atributos calculados, acceder a entidades, exportar datos de perfil y eliminar conjuntos de datos o lotes innecesarios.
El uso de la guía para desarrolladores requiere una comprensión práctica de los distintos servicios de Adobe Experience Platform implicados en el trabajo con datos de Profile. Antes de comenzar a trabajar con la API Real-Time Customer Profile, revise la documentación de los siguientes servicios:
- Real-Time Customer Profile: proporciona un perfil de cliente unificado en tiempo real en función de los datos agregados de varias fuentes.
- Adobe Experience Platform Identity Service: obtenga una mejor vista de su cliente y de su comportamiento al unir identidades entre dispositivos y sistemas.
- Adobe Experience Platform Segmentation Service: permite crear audiencias a partir de los datos del perfil del cliente en tiempo real.
- 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 instancia de Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Las secciones siguientes proporcionan información adicional que necesitará conocer para realizar llamadas exitosas a Profile extremos de API.
Lectura de llamadas de API de muestra
La documentación de la API Real-Time Customer Profile proporciona ejemplos de llamadas a la API para mostrar cómo dar formato a las solicitudes correctamente. 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 de 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 de Experience Platform.
Encabezados obligatorios
La documentación de la API también requiere que haya completado el tutorial de autenticación para realizar llamadas correctamente a Platform extremos. Al completar el tutorial de autenticación, se proporcionan los valores de cada uno de los encabezados necesarios en las llamadas a la API Experience Platform, como se muestra a continuación:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Todos los recursos de Experience Platform están aislados en zonas protegidas virtuales específicas. Las solicitudes a las API 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.
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.
Pasos siguientes
Para empezar a realizar llamadas mediante la API Real-Time Customer Profile, seleccione una de las guías de extremos disponibles.