Présentation

​

Prise en main du groupe d’endpoints de List épinglée

Ce bref aperçu vous aidera à effectuer votre première requête vers les endpoints de List épinglée à l’aide de Postman.

Veuillez consulter notre dépôt GitHub X API v2 sample code si vous souhaitez voir des exemples de code dans différentes langues.

​

Prérequis

Pour suivre ce guide, vous aurez besoin d’un ensemble de clés et jetons pour authentifier votre requête. Vous pouvez générer ces clés et jetons en suivant ces étapes :

• Inscrivez-vous pour obtenir un compte développeur et obtenez l’approbation.
• Créez un Project et une App développeur associée dans le developer portal.
• Accédez à la page “Keys and tokens” de votre App pour générer les identifiants requis. Assurez-vous d’enregistrer tous les identifiants dans un emplacement sécurisé.

Charger la collection Postman X API v2

Pour charger la collection Postman X API v2 dans votre espace de travail, veuillez cliquer sur le bouton suivant :

Add X API v2 to Postman

 

​

Authentifiez votre requête

Pour effectuer une requête réussie vers les endpoints de lookup, vous pouvez utiliser Contexte utilisateur OAuth 1.0a, OAuth 2.0 App-Only ou OAuth 2.0 Autorisation par code avec PKCE. En revanche, pour les endpoints de manage, vous pouvez uniquement vous authentifier avec Contexte utilisateur OAuth 1.0a ou OAuth 2.0 Autorisation par code avec PKCE.

Dans tous les cas, lorsque vous utilisez Postman, les clés et jetons d’authentification par défaut seront automatiquement renseignés dans vos requêtes dès lors que votre environnement est correctement configuré.

Pour ce faire, sélectionnez l’environnement nommé « X API v2 » (dans le coin supérieur droit de Postman) et ajoutez vos clés et jetons dans les champs « initial value » et « current value » (en cliquant sur l’icône en forme d’œil à côté de la liste déroulante des environnements). Ces clés incluent les éléments suivants :

• API Key (également appelée Consumer Key)
• Clé secrète de l’API (également appelée Consumer Secret)
• Access Token utilisateur OAuth 1.0a
• Access Token Secret utilisateur OAuth 1.0a
• App Access Token OAuth 2.0
• OAuth 2.0 Client Key (disponible uniquement si vous avez configuré les paramètres d’authentification utilisateur OAuth 2.0 dans les paramètres de votre App)
• OAuth 2.0 Client Secret (disponible uniquement si vous avez configuré les paramètres d’authentification utilisateur OAuth 2.0 dans les paramètres de votre App)