Prise en main de l’API Data Ingestion getting-started
À l’aide des points de terminaison de l’API Data Ingestion, vous pouvez effectuer des opérations CRUD de base afin d’ingérer des données dans Adobe Experience Platform.
L’utilisation des guides de l’API nécessite une compréhension pratique de plusieurs services Adobe Experience Platform impliqués dans l’utilisation des données. Avant d’utiliser l’API Data Ingestion, consultez la documentation relative aux services suivants :
- Ingestion par lots : vous permet d’ingérer des données dans Adobe Experience Platform sous forme de fichiers de lots.
- Real-Time Customer Profile : fournit un profil client en temps réel unifié basé sur des données agrégées provenant de plusieurs sources.
- Experience Data Model (XDM) : cadre normalisé selon lequel Platform organise les données d’expérience client.
- Sandboxes : Experience Platform fournit des sandbox virtuels qui divisent une instance Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Les sections suivantes apportent des informations supplémentaires dont vous aurez besoin pour passer avec succès des appels à des points de terminaison d’API Profile.
Lecture d’exemples d’appels API
La documentation de l’API Data Ingestion fournit des exemples d’appels API pour démontrer comment formater correctement les requêtes. 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. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels d’API, voir la section concernant la lecture d’exemples d’appels d’API dans le guide de dépannageExperience Platform.
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 d’entrée Platform Le tutoriel sur l’authentification indique les valeurs de chacun des en-têtes requis dans les appels d’API Experience Platform, comme illustré ci-dessous :
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Toutes les requêtes ayant un payload dans le corps de la requête (notamment les appels POST, PUT et PATCH) doivent comporter un en-tête Content-Type. Les valeurs acceptées propres à chaque appel sont fournies dans les paramètres d’appel.
Dans Experience Platform, toutes les ressources sont isolées dans des sandbox virtuels spécifiques. Les requêtes envoyées aux API Platform nécessitent un en-tête spécifiant le nom de l’environnement de test dans lequel l’opération aura lieu :
x-sandbox-name: {SANDBOX_NAME}
Pour plus d’informations sur les sandbox dans Platform, consultez la documentation de présentation des sandbox.