SUJETS×
À lire absolument
Exigences techniques
- Les API d’Adobe Campaign doivent être utilisées de serveur en serveur uniquement.
- Vérifiez toujours avec votre contact technique Adobe si le cas d’utilisation que vous souhaitez implémenter est aligné sur l’échelle autorisée par les API Adobe Campaign.
- La configuration d’un accès AdobeIO requiert des autorisations spécifiques. Contactez le support technique d’Adobe pour tout problème.
Représentation des ressources
Toutes les ressources d’API sont disponibles dans
JSON
avec une extension d’URL ou dans un en-tête d’acceptation HTTP :
GET /profileAndServices/<resourceName>.json
Sans extension dans l’URL, le format
json est celui
par défaut pour le type de contenu.
exemple de demande
-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile.json \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <ACCESS_TOKEN>' \ -H 'Cache-Control: no-cache' \ -H 'X-Api-Key: <API_KEY>'
Clé principale et URL
- N'essayez pas de créer une URL par vous-même. Toutes les URL sont renvoyées par l’API. Cependant, il est possible de créer une URL basée sur le nom de ressource de niveau supérieur.
- Les valeurs de clé primaire automatique (PKey) qui illustrent les exemples ne sont pas destinées à fonctionner dans un autre déploiement spécifique. Elles sont produites par l’API Adobe Campaign.
- Les valeurs de clé primaire automatique générées par Adobe Campaign ne doivent jamais être stockées dans une base de données ou un site Web externe. Vous devez générer des champs clés spécifiques dans la définition de votre base de données et les utiliser lors de vos développements.
Clés personnalisées
Si la ressource de profil a été étendue avec un champ de clé personnalisé, vous pouvez utiliser ce champ comme clé au lieu de la clé primaire automatique générée par Adobe Campaign :
GET /.../profileAndServicesExt/profile/<customKey>
Les clés personnalisées ne peuvent pas être modifiées à l’aide d’une opération PATCH si la valeur de la clé est différente de la clé d’origine ou si vous utilisez votre propre clé d’entreprise comme URI au lieu de celle fournie par Adobe.
Utilisez une clé personnalisée pour les ressources
de profil de
niveau supérieur uniquement. Les URL sont renvoyées par l’API et ne doivent jamais être créées par vous-même.
Exemple de requête
Pour récupérer les abonnements d’un profil à l’aide d’une clé personnalisée, effectuez une opération GET sur la clé personnalisée.
-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/<customKey> \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <ACCESS_TOKEN>' \ -H 'Cache-Control: no-cache' \ -H 'X-Api-Key: <API_KEY>'
Exécutez une requête GET sur l’URL d’abonnement renvoyée.
-X GET <SUBSCRIPTION_URL> \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <ACCESS_TOKEN>' \ -H 'Cache-Control: no-cache' \ -H 'X-Api-Key: <API_KEY>'
Elle renvoie la liste des abonnements pour le profil.
"service": { "PKey": "<PKEY>", "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>", "label": "Sport Newsletter", "name": "SVC1", "title": "Sport Newsletter (SVC1)" }