Introducción a la API Policy Service
La API Policy Service le permite crear y administrar varios recursos relacionados con la administración de datos de Adobe Experience Platform. Este documento proporciona una introducción a los conceptos principales que necesita conocer antes de intentar realizar llamadas a la API Policy Service.
Requisitos previos
El uso de la guía para desarrolladores requiere una comprensión práctica de los distintos servicios de Experience Platform implicados en el trabajo con las capacidades de control de datos. Antes de comenzar a trabajar con Policy Service API, revise la documentación de los siguientes servicios:
- Control de datos: El marco por el cual Experience Platform aplica el cumplimiento del uso de datos.
- Experience Data Model (XDM) System: El marco estandarizado mediante el cual Experience Platform organiza los datos de experiencia del cliente.
- Real-Time Customer Profile: proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
- Zonas protegidas: 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.
Lectura de llamadas de API de muestra
La documentación de la API Policy Service proporciona ejemplos de llamadas a la 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 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, incluidos los que pertenecen a Control de datos, están aislados en zonas protegidas virtuales específicas. Todas 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}
Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado adicional:
Content-Type: application/json
Recursos principales y personalizados
Dentro de la API Policy Service, todas las políticas y acciones de marketing se denominan recursos core o custom.
core recursos son los definidos y mantenidos por el Adobe, mientras que custom recursos son los creados y mantenidos por su organización y, por lo tanto, son únicos y visibles únicamente para su organización. De este modo, las operaciones de listado y búsqueda (GET) son las únicas permitidas en core recursos, mientras que las operaciones de listado, búsqueda y actualización (POST, PUT, PATCH y DELETE) están disponibles para custom recursos.
Pasos siguientes
Para empezar a realizar llamadas mediante la API del servicio de directivas, seleccione una de las guías de extremos disponibles.