Guía de la API de Identity Service
Adobe Experience Platform Identity Service administra la identificación de sus clientes en varios dispositivos, canales cruzados y casi en tiempo real en lo que se conoce como gráfico de identidad dentro de Adobe Experience Platform.
Introducción
Esta guía requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
- Identity Service: resuelve el desafío fundamental que plantea la fragmentación de los datos de perfil del cliente. Para ello, une las identidades entre dispositivos y sistemas en los que los clientes interactúan con la marca.
- Real-Time Customer Profile: Proporciona un perfil unificado de consumidor 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.
Las secciones siguientes proporcionan información adicional que deberá conocer o tener disponible para poder realizar llamadas correctamente a Identity Service API.
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 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.
Recopilación de valores para los encabezados obligatorios
Para realizar llamadas a Platform API, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados obligatorios en todas las llamadas de API de Experience Platform, como se muestra a continuación:
- Autorización: Portador
{ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Todos los recursos de Experience Platform están aisladas para zonas protegidas virtuales específicas. Todas las 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}
Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado adicional:
- Content-Type: application/json
Enrutamiento basado en regiones
El Identity Service La API emplea puntos de conexión específicos de región que requieren la inclusión de una {REGION} como parte de la ruta de solicitud. Durante el aprovisionamiento de la organización, se determina una región y se almacena dentro del perfil de la organización. El uso de la región correcta con cada extremo garantiza que todas las solicitudes realizadas con el Identity Service Las API se dirigen a la región adecuada.
Actualmente, admite dos regiones: Identity Service API: VA7 y NLD2.
En la tabla siguiente se muestran ejemplos de rutas que utilizan regiones:
Si no puede localizar la región dentro del perfil de su organización, póngase en contacto con el administrador del sistema para obtener ayuda.
Uso del Identity Service API
Los parámetros de identidad utilizados en estos servicios se pueden expresar de una de las dos maneras siguientes: compuesto o XID.
Las identidades compuestas son construcciones que incluyen el valor de ID y el área de nombres. Cuando se utilizan identidades compuestas, el área de nombres se puede proporcionar mediante el nombre (namespace.code) o ID (namespace.id).
Cuando persiste una identidad, Identity Service genera y asigna un ID a esa identidad, denominado ID nativo o XID. Todas las variaciones de las API de clúster y asignación admiten identidades compuestas y XID en sus solicitudes y respuestas. Uno de los parámetros es obligatorio: xid o combinación de [ns o nsid] y id para utilizar estas API.
Para limitar la carga útil en las respuestas, las API adaptan sus respuestas al tipo de construcción de identidad utilizada. Es decir, si pasa XID, las respuestas tendrán XID, si pasa identidades compuestas, la respuesta seguirá la estructura utilizada en la solicitud.
Los ejemplos de este documento no abarcan la funcionalidad completa del Identity Service API. Para ver la API completa, consulte la Referencia de API de Swagger.
Pasos siguientes
Ahora que ha recopilado las credenciales necesarias, puede seguir leyendo el resto de la guía para desarrolladores. Cada sección proporciona información importante sobre sus puntos de conexión y muestra llamadas de API de ejemplo para realizar operaciones de CRUD. Cada llamada a incluye el formato de API general, una solicitud de ejemplo que muestra los encabezados necesarios y las cargas útiles con el formato adecuado, así como una respuesta de ejemplo para una llamada correcta.