Certaines API ou extensions nécessitent un identifiant de liste pour importer une liste de contacts spécifique. Si vous devez fournir un identifiant de liste, vous pouvez toujours contacter notreportail de développeurs ou envoyer un e-mail à l’adresse webservices@constantcontact.com au sujet de l’intégration/l’application que vous utilisez.
Développeurs
Les développeurs peuvent utiliser la fonctionnalité intégrée pour obtenir des listes dans un des SDK. Ils peuvent également utiliser les documents IO de Constant Contact ou un client REST pour effectuer un appel d’API Get/lists.
Non-développeurs
Les non-développeurs peuvent utiliser nos API pour récupérer les identifiants de liste dans leurs comptes. Les informations récupérées comprennent le nom et l’identifiant de liste. Si vous utilisez une intégration tierce nécessitant de générer des identifiants de liste :
- Nous avons deux versions différentes de l’API. Les actions à entreprendre pour générer des identifiants de liste dépendent de la version de notre API et de l’intégration que vous souhaitez connecter aux utilisateurs. En effet, elles sont créées sur différentes plateformes et ne sont pas toujours compatibles.
- Le format de l’identifiant de liste varie selon si l’intégration utilise l’ancienne API v2 (identifiant de liste à 10 chiffres) ou l’actuelle API v3 (identifiant de liste à 32 chiffres), vous devez donc vérifier le format dont vous avez besoin.
API v3
API v2
API v3
Si votre intégration requiert un identifiant de liste à 32 chiffres, alors elle utilise notre version plus récente, l’API v3 :
- Connectez-vous à votre compte Constant Contact.
- Ouvrez le v3 API Developer Portal (Portail des développeurs de l’API v3).
- Cliquez sur API References (Références d’API).
- Cliquez sur Get Lists Collection (Obtenir la collecte de listes) > GET Lists Collection.
- Faites défiler l’écran jusqu’à la section Test this endpoint (Tester ce point de terminaison).
- Cliquez sur le bouton Oauth et donnez l’autorisation à l’API d’accéder à votre compte Constant Contact.
- Cliquez sur le bouton Try (Essayer) pour que toutes vos listes s’affichent ici, avec leur identifiant à 32 chiffres.
{ "list_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "name": "General Interest", "favorite": false, "created_at": "2021-01-00T00:00:00Z", "updated_at": "2021-01-00T00:00:00Z" }
Pour obtenir de l’aide supplémentaire sur l’utilisation de l’API v3, veuillez consulter la section de documentation sur l’API de notre portail des développeurs.
API v2
Suivez ces étapes pour utiliser nos IO Docs et effectuer un appel d’API via l’ancienne API v2 :
- Connectez-vous à votre compte Constant Contact.
- Ouvrez le tableau de bord de l’API v2. Vous devez vous inscrire ou créer un nouveau compte et enregistrer votre application si vous n’en avez pas déjà. Les identifiants de connexion ne sont pas les mêmes que ceux de votre compte Constant Contact.
- Cliquez sur Apps & API Keys (Applications et clés d’API).
- Cliquez sur Applications.
- Cliquez sur Create a New Application (Créer une application). Cela sert uniquement à établir une connexion avec votre compte Constant Contact pour obtenir les identifiants de liste.
- Saisissez ce que vous souhaitez dans le champ Application Name (Nom de l’application). Vous ne devez rien remplir d’autre.
- Consultez nos conditions générales d’utilisation et cochez la case pour les accepter.
- Cliquez sur Register Application (Enregistrer l’application).
- Cliquez sur l’onglet API Tester (Testeur d’API). (La clé d’API est préremplie avec le contenu du champ du nom de l’application de l’étape 5)
- Cliquez sur Get Access Token (Obtenir un jeton d’accès).
- Cliquez sur Allow (Autoriser). Si vous n’êtes pas connecté à votre compte Constant Contact, on vous demandera d’abord de vous authentifier.
- Copiez le jeton d’accès puis cliquez sur Done (Terminé). Nous vous recommandons de sauvegarder le jeton d’accès pour un usage ultérieur.
- Collez le jeton d’accès dans le champ Enter access token (Saisir le jeton d’accès).
- Faites défiler l’écran jusqu’à la section ContactList methods (Méthodes de listes de contacts) et cliquez sur le bouton GET (Obtenir) à côté de l’option « Retrieve a collection of ContactLists » (Récupérer une collecte de listes de contacts).
- Cliquez sur Try it!
(Essayer maintenant !) - Dans la section Response Body (Corps de la réponse), toutes vos listes s’affichent avec leur identifiant de liste à 10 chiffres.
{ "id": "xxxxxxxxxx", "name": "General Interest", "status": "HIDDEN", "created_date": "2021-01-01T00:00:00.000Z", "modified_date": "2021-01-01T00:00:00.000Z", "contact_count": 0
Pour obtenir de l’aide supplémentaire sur l’utilisation de l’API v2, veuillez consulter la section de documentation sur l’API du portail des développeurs v2.
