Aperçu

​

Bien démarrer avec le groupe d’endpoints List members

Cette présentation rapide vous aidera à effectuer votre première requête vers les endpoints List members à l’aide de Postman.

Si vous souhaitez voir des exemples de code dans différents langages, veuillez consulter notre dépôt GitHub X API v2 sample code.

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 informations d’identification requises. Assurez-vous d’enregistrer toutes ces informations dans un endroit sécurisé.

​

Importer la collection Postman X API v2

Pour importer la collection Postman X API v2 dans votre espace de travail, cliquez sur le bouton suivant :

Ajouter X API v2 à Postman

​

Authentifiez votre requête

Pour envoyer une requête réussie aux endpoints de lookup, vous pouvez utiliser Contexte utilisateur OAuth 1.0a, App only ou OAuth 2.0 Autorisation par code avec PKCE. En revanche, pour les endpoints de manage, vous ne pouvez vous authentifier qu’avec le 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, à condition que vous ayez correctement configuré votre environnement.

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é du menu déroulant de l’environnement). Ces clés incluent notamment :

• 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 only Access Token
• OAuth 2.0 Client Key (uniquement disponible si vous avez configuré l’authentification utilisateur OAuth 2.0 dans les paramètres de votre App)
• OAuth 2.0 Client Secret (uniquement disponible si vous avez configuré l’authentification utilisateur OAuth 2.0 dans les paramètres de votre App)