Récupérer des abonnements à l’aide des API

Dernière mise à jour : 26 mars 2024
  • Rubriques :
  • API

Créé pour :

  • Expérimenté
  • Développeur

Récupération des profils abonnés à un service

Cette procédure comporte deux étapes.

  1. Récupérez l’URL des abonnements pour le service souhaité.
  2. Exécutez une requête GET sur l’URL des abonnements. Elle renvoie la liste des abonnements pour le service, avec chaque profil associé.
CAUTION
L’API REST renvoie la propriété « href », qui contient l’URL à utiliser. Utilisez systématiquement l’URL contenue dans la réponse pour exécuter la requête d’API suivante.

Exemple de requête

Exécutez une requête GET pour récupérer le service.

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

Elle renvoie l’URL des abonnements du service.

  {
    ...
    "messageType": "email",
    "name": "SVC1",
    "subscriptions": {
                "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>/subscriptions/"
    },
    ...
  },

Exécutez une requête GET sur l’URL des abonnements.

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>/subscriptions \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

La liste des abonnements pour le service s’affiche, avec chaque profil associé.

  {
    ...
    "service": ...,
    "serviceName": "SVC3",
    "subscriber": {
        "PKey": "<PKEY>",
        "email": "",
        "firstName": "John",
        "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile/<PKEY>",
        "lastName": "Doe",
    },
  }