En-tête de type de contenu
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 sont spécifiques à chaque point d’entrée de l’API. Si une valeur d’Content-Type
spécifique est nécessaire pour un point d’entrée, sa valeur s’affiche dans les exemples de requêtes d’API fournis par les guides d’API pour les services Experience Platform individuels.
Principes fondamentaux des API d’Experience Platform
Les API Adobe Experience Platform utilisent plusieurs technologies et syntaxes sous-jacentes importantes à comprendre pour gérer efficacement les ressources Experience Platform.
Pour en savoir plus sur les technologies d’API sous-jacentes utilisées par Experience Platform, y compris des exemples d’objets de schéma JSON, consultez le guide Principes de base de l’API Experience Platform.
Collections Postman pour les API Experience Platform
Postman est une plateforme de collaboration pour le développement d’API qui vous permet de configurer des environnements avec des variables prédéfinies, de partager des collections d’API, de rationaliser les requêtes CRUD, etc. La plupart des services d’API Experience Platform possèdent des collections Postman qui peuvent être utilisées pour faciliter l’émission d’appels d’API.
Pour en savoir plus sur Postman, notamment sur la configuration d’un environnement, sur une liste des collections disponibles et sur l’importation de collections, consultez la documentation Experience Platform Postman.
Lecture d’exemples d’appels API
Les formats de requête varient selon l’API Experience Platform utilisée. Le meilleur moyen d’apprendre à structurer vos appels API est de suivre les exemples fournis dans la documentation du service Experience Platform que vous utilisez.
La documentation de Experience Platform présente les exemples d’appels API de deux manières différentes. Tout d’abord, l’appel est présenté dans son format d’API, qui consiste en une représentation de modèle affichant uniquement l’opération (GET, POST, PUT, PATCH, DELETE) et le point d’entrée utilisé (par exemple /global/classes
). Certains modèles indiquent également l’emplacement des variables pour mieux illustrer la manière dont un appel doit être formulé, comme par exemple GET /{VARIABLE}/classes/{ANOTHER_VARIABLE}
.
Les appels sont ensuite affichés sous forme de commandes cURL dans une Requête, qui comprend les en-têtes nécessaires et le « chemin racine » complet indispensable pour que l’interaction avec l’API soit réussie. Le chemin racine doit être ajouté à tous les points d’entrée. Par exemple, le point d’entrée /global/classes
cité plus haut devient https://platform.adobe.io/data/foundation/schemaregistry/global/classes
. Le format/modèle de requête de l’API est visible dans toute la documentation et vous devez utiliser le chemin d’accès complet illustré dans l’exemple de requête lorsque vous effectuez vos propres appels vers les API Experience Platform.