Les API Adobe : quelles API et à quoi elles servent

Adobe propose de nombreuses API, et on ne sait pas toujours laquelle sert à quoi. Ce guide les passe en revue une par une : à quoi elle sert, des cas d’usage concrets et la documentation officielle. Chaque API cible une partie précise du cycle de vie de la donnée.

1. Adobe Developer Console : le point d’entrée unique

Rôle : le hub central pour créer des projets, générer des identifiants et activer des services. Pour les jobs back-end, utilisez OAuth Server-to-Server : les identifiants JWT sont arrivés en fin de vie le 30 juin 2025 (voir Adobe : migration depuis JWT). À retenir : presque toutes les API Adobe exigent un projet Developer Console et des identifiants (exception : les connexions de streaming non authentifiées). Documentation.

2. Experience Platform API : la couche de base

Rôle : gérer les composants centraux d’Experience Platform : schémas XDM, datasets et ingestions par lots (batch). Cas d’usage : créer automatiquement un nouveau schéma XDM, charger un fichier CSV dans un dataset, vérifier le statut d’une ingestion par lots. Documentation.

3. Streaming Ingestion API : la donnée en temps réel

Rôle : envoyer des événements en temps réel depuis des back-ends, des CRM, des apps. Cas d’usage : pousser un événement d’achat depuis votre back-end, connecter des systèmes hors ligne à Adobe, suivre des interactions client hors web. Documentation.

4. Segmentation Service API : le moteur d’audiences

Rôle : gérer les segments Adobe par programme : créer des définitions de segments (audiences), lancer des jobs de segmentation pour les évaluer, lancer des jobs d’export pour extraire les profils qualifiés. Cas d’usage : déclencher le recalcul d’un segment par API, planifier des mises à jour dynamiques d’audiences, exporter les profils éligibles vers une destination. Documentation.

5. Query Service API : du SQL pour XDM

Rôle : interroger les datasets Adobe en SQL, avec la possibilité d’enregistrer les résultats dans un dataset. Cas d’usage : explorer les données en SQL, automatiser des analyses avancées sans passer par l’interface, créer des pipelines de post-traitement. Documentation.

6. Destinations et Flow Service APIs (Real-Time CDP) : activer vers des destinations

Rôle : piloter l’activation d’audiences vers différentes destinations : médias payants (Facebook, Google), outils internes ou CRM, data lakes. Cas d’usage : déclencher une synchronisation d’audience Facebook, lister les destinations disponibles, automatiser des jobs d’activation. Documentation · Flow Service API.

7. Adobe Analytics API (v2.0) : les données de Workspace

Rôle : extraire les données de Workspace par API : métriques, dimensions, segments, métriques calculées et autres composants. Cas d’usage : obtenir les 10 pages les plus vues, exporter des KPI quotidiens vers Slack ou par e-mail, construire des dashboards hors de Workspace. Documentation.

7 bis. Customer Journey Analytics API : gère les composants de Customer Journey Analytics : connexions, data views et rapports. Documentation.

8. Adobe Target API : l’automatisation des expérimentations

Rôle : gérer les tests A/B et multivariés : créer ou modifier des activités, récupérer les résultats, ajuster les règles de ciblage. Cas d’usage : lancer des expériences par API, suivre la performance, mettre à jour le contenu dynamiquement. Documentation.

9. Adobe Campaign Standard API : le pilotage des messages

Les clients de Campaign Standard migrent vers Campaign v8 : vérifiez quel produit vous avez avant de construire sur cette API (voir la documentation Adobe Campaign Standard). Rôle : gérer l’envoi d’e-mails, SMS et push depuis Campaign : créer ou mettre à jour des profils, ajouter des utilisateurs à des listes, déclencher des messages transactionnels. Cas d’usage : déclencher des e-mails depuis un webhook, synchroniser des données entre systèmes, piloter les workflows Campaign depuis des applications externes. Documentation.

API bonus à connaître

Schema Registry API : définir et versionner les schémas.
Catalog Service API : parcourir les datasets et leurs métadonnées.
Access Control API : gérer les droits et permissions des utilisateurs.

Exemple d’appel : Streaming Ingestion API

curl -X POST 'https://dcs.adobedc.net/collection/{CONNECTION_ID}?syncValidation=true' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
  "header": {
    "datasetId": "{DATASET_ID}",
    "flowId": "{FLOW_ID}",
    "imsOrgID": "{ORG_ID}"
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
        "contentType": "application/vnd.adobe.xed-full+json;version=1"
      }
    },
    "xdmEntity": {
      "_id": "...",
      "timestamp": "2025-08-05T10:10:00Z",
      "eventType": "commerce.purchases"
    }
  }
}'

L’ID dans l’URL est l’ID de la connexion de streaming, pas un ID de dataset. Le corps est du XDM : un header (dataset, flow, organisation) et un body avec la référence du schéma et l’événement. Un corps JSON à plat ne fonctionne que si un dataflow avec mapping (data prep) est configuré. Les en-têtes d’autorisation ne sont nécessaires que pour les connexions authentifiées. Source : Adobe : envoyer des données de séries temporelles en streaming.

En conclusion

L’écosystème d’Adobe est modulaire, et ses API aussi : ingestion (par lots et en temps réel), audiences et segmentation, exploration en SQL, activation multicanal, extraction analytics, envoi de messages. Savoir quelle API utiliser (et comment s’authentifier correctement) ouvre de vraies possibilités d’automatisation.

Sources

Pour aller plus loin, lisez la version complète de l’article (en anglais) : Full Guide: What Adobe APIs Are Available and What They Do.

Besoin d’aide sur ce sujet ? Consultant Adobe Analytics.

Guide complet : quelles API Adobe existent et à quoi servent-elles