Introducción a la API Policy Service

La API Policy Service le permite crear y administrar varios recursos relacionados con Adobe Experience Platform Data Governance. Este documento proporciona una introducción a los conceptos principales que debe conocer antes de intentar realizar llamadas a la API Policy Service.

Requisitos previos

El uso de la guía para desarrolladores requiere comprender bien los distintos servicios Experience Platform que intervienen en el trabajo con las funcionalidades de control de datos. Antes de comenzar a trabajar con Policy Service API, revise la documentación de los siguientes servicios:

  • Data Governance: El marco mediante el cual se Experience Platform aplica el cumplimiento de las normas de uso de datos.
  • Experience Data Model (XDM) System: El marco estandarizado mediante el cual se Experience Platform organizan los datos de experiencia del cliente.
  • Real-time Customer Profile: Proporciona un perfil de cliente unificado y en tiempo real basado en datos agregados de varias fuentes.
  • Simuladores para pruebas: 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.

Leer llamadas de API de ejemplo

La documentación de la API Policy Service proporciona ejemplos de llamadas de API para demostrar cómo dar formato a sus 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}

Todos los recursos de Experience Platform, incluidos los que pertenecen a Data Governance, están aislados en entornos limitados virtuales específicos. Todas las solicitudes a 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}
NOTA

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

Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado adicional:

  • Content-Type: application/json

Recursos principales vs. recursos personalizados

Dentro de la API Policy Service, todas las políticas y acciones de marketing se denominan core o custom recursos.

core los recursos son los definidos y mantenidos por el Adobe, mientras que los 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 IMS. De este modo, las operaciones de listado y búsqueda (GET) son las únicas operaciones permitidas en los recursos core, mientras que las operaciones de listado, búsqueda y actualización (POST, PUT, PATCH y DELETE) están disponibles para los recursos custom.

Pasos siguientes

Para empezar a realizar llamadas mediante la API del servicio de directivas, seleccione una de las guías de punto final disponibles.

En esta página