Passer au contenu principal

​
Bien démarrer avec l’endpoint de consultation des Bookmarks

Ce guide de démarrage rapide vous aidera à effectuer votre première requête vers l’endpoint de consultation des Bookmarks à 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 les étapes ci-dessous :

​
Étapes pour créer une requête de recherche de signets

Première étape : commencer avec un outil ou une bibliothèque Plusieurs outils, exemples de code et bibliothèques peuvent être utilisés pour effectuer une requête vers cet endpoint, mais nous utiliserons ici l’outil Postman pour simplifier le processus. Pour charger la collection Postman X API v2 dans votre environnement, veuillez cliquer sur le bouton suivant :
Une fois la collection X API v2 chargée dans Postman, accédez au dossier “Bookmarks”, puis sélectionnez “Bookmarks lookup”. Deuxième étape : authentifier votre requête Pour effectuer une requête réussie vers cet endpoint, vous devrez utiliser le flux d’autorisation OAuth 2.0 Authorization Code avec PKCE. Vous pouvez générer un access token dans Postman. Accédez à l’onglet “Authorization” et sélectionnez “OAuth 2.0”. Dans cet onglet, suivez les étapes suivantes :
  1. Nommez votre jeton.
  2. Sélectionnez le Grant Type “Authorization Code (with PKCE)”.
  3. Mettez à jour les paramètres : Callback URL - https://www.example.com Elle doit correspondre à l’URL de rappel que vous avez définie sur la page des paramètres d’authentification dans le developer portal. Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - Copiez-collez l’OAuth 2.0 client ID depuis le developer portal Client Secret - Copiez-collez l’OAuth 2.0 client secret depuis le developer portal. Vous n’en aurez besoin que si vous utilisez un type d’App « confidential client ».
  4. Mettez à jour les scopes avec les valeurs suivantes : post.read users.read bookmark.read
  5. Renseignez le champ state avec “State”.
  6. Cliquez sur “Generate Token”.
  7. Appuyez sur l’icône d’enregistrement pour sauvegarder les modifications du dossier.
Vous pouvez recevoir un message indiquant que vous n’êtes pas connecté à X. Si vous obtenez cette erreur, connectez-vous au compte X, dans Postman, au nom duquel vous essayez d’effectuer l’action. Troisième étape : spécifier un utilisateur Avec cet endpoint, vous devez spécifier l’id de l’utilisateur dont vous souhaitez recevoir les abonnés dans la réponse. Par exemple, l’id de @XDevelopers est 2244994945. Dans Postman, accédez à l’onglet “Params” et saisissez l’id de vous-même ou d’un utilisateur authentifié comme valeur pour le paramètre id.
KeyValue
id2244994945
Quatrième étape : envoyer votre requête et examiner la réponse Une fois que tout est configuré, cliquez sur le bouton “Send” et vous recevrez une réponse similaire à l’exemple suivant : 
{
   "data": [
       {
           "id": "1501258597237342208",
           "text": "🗣 Avez-vous développé un projet utilisant l'X API que vous aimeriez partager avec la communauté ? Nous serions ravis d'avoir de vos nouvelles. Partagez votre projet avec nous !"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 Ce n'est là qu'une façon dont l'innovation des développeurs contribue à améliorer Twitter. Vous pouvez trouver d'autres outils prêts à l'emploi créés par notre communauté de développeurs dans notre Twitter Toolbox ici ⬇️ https://t.co/rK0X30JSYU"
       },
       {
           "id": "1501257716941000709",
           "text": "📣Aujourd'hui est un jour important ! \nNous nous sommes associés à @Jigsaw pour le lancement de ce nouvel outil. Cette collaboration permet aux ONG et aux organisations à but non lucratif de créer des outils qui aident les gens à rester en sécurité sur Twitter en répondant aux besoins et aux préférences des communautés qu'elles servent. En savoir plus ⬇️ https://t.co/MmznmgxoWT"
       },
       {
           "id": "1501686770810900485",
           "text": "Rejoignez-nous demain pour poursuivre la conversation sur la personnalisation des chronologies et comment cela pourrait fonctionner pour les développeurs. Et restez à l'écoute pour d'autres Spaces la semaine prochaine. 👀 https://t.co/P4JTc14mdC"
       },
       {
           "id": "1501596763194593285",
           "text": "L'innovation des développeurs est toujours importante, y compris en temps de crise. Si vous créez des outils pour aider à connecter les gens, les protéger, ou partager des informations avec le monde, nous sommes là pour vous soutenir—répondez à ce Tweet pour nous en dire plus sur votre application."
       }
   ]
}
⌘I