Show Menu
SUJETS×

Getting started with the Policy Service API

L’ Policy Service API vous permet de créer et de gérer diverses ressources liées à Adobe Experience Platform Data Governance. This document provides an introduction to the core concepts you need to know before attempting to make calls to the Policy Service API.

Conditions préalables

L'utilisation du guide du développeur nécessite une compréhension pratique des différents Experience Platform services impliqués dans l'utilisation des capacités de gouvernance des données. Before beginning to work with the Policy Service API, please review the documentation for the following services:
  • Gouvernance des données : Cadre selon lequel Experience Platform applique la conformité à l’utilisation des données.
  • Système de modèle de données d’expérience (XDM) : Cadre normalisé selon lequel Experience Platform organiser les données d’expérience client.
  • Profil client en temps réel : Fournit un profil de consommation unifié en temps réel basé sur des données agrégées provenant de plusieurs sources.
  • Sandbox : Experience Platform fournit des sandbox virtuels qui partitionnent une Platform instance unique en environnements virtuels distincts pour aider à développer et développer des applications d'expérience numérique.

Lecture d’exemples d’appels API

The Policy Service API documentation provides example API calls to demonstrate how to format your requests. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. For information on the conventions used in documentation for sample API calls, see the section on how to read example API calls in the Experience Platform troubleshooting guide.

En-têtes requis

La documentation de l’API exige aussi que vous ayez suivi le tutoriel sur l’authentification pour lancer des appels vers des points de terminaison Platform Completing the authentication tutorial provides the values for each of the required headers in Experience Platform API calls, as shown below:
  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
All resources in Experience Platform, including those belonging to Data Governance, are isolated to specific virtual sandboxes. All requests to Platform APIs require a header that specifies the name of the sandbox the operation will take place in:
  • x-sandbox-name: {SANDBOX_NAME}
For more information on sandboxes in Platform, see the sandbox overview documentation .
Toutes les requêtes contenant un payload (POST, PUT, PATCH) requièrent un en-tête supplémentaire :
  • Content-Type: application/json

Ressources de base ou personnalisées

Within the Policy Service API, all policies and marketing actions are referred to as either core or custom resources.
core les ressources sont celles définies et maintenues par l'Adobe, tandis que custom les ressources sont celles créées et entretenues par votre organisation et sont donc uniques et visibles uniquement par votre organisation IMS. Les opérations de liste et de recherche ( GET ) sont donc les seules opérations autorisées sur les ressources core , alors que les opérations de liste, de recherche et de mise à jour ( POST , PUT , PATCH et DELETE ) sont disponibles pour les ressources custom .

Étapes suivantes

Pour commencer à effectuer des appels à l’aide de l’API de service de stratégie, sélectionnez l’un des guides de points de terminaison disponibles.