Passer au contenu principal
Remarque : Ce guide suppose que vous avez terminé les prérequis de la vue d’ensemble « Bien démarrer ».

​
Étapes pour créer une requête de recherche de List épinglée

Première étape : Choisir la collection d’endpoint List dans Postman Une fois la collection X API v2 chargée dans Postman, accédez au dossier « List », sélectionnez le dossier « Pinned Lists », puis choisissez « User’s pinned Lists ».   Deuxième étape : Identifier et spécifier l’utilisateur Pour récupérer la List épinglée d’un utilisateur, vous devez spécifier son ID utilisateur dans la requête. Cet ID doit correspondre à l’ID de l’utilisateur authentifié, ce qui signifie que vous devez transmettre les Access Tokens associés à cet ID lors de l’authentification de votre requête. Dans cet exemple, vous pouvez indiquer l’ID de votre propre utilisateur. Vous pouvez trouver votre ID de deux manières :
  1. En utilisant l’endpoint users lookup par nom d’utilisateur, vous pouvez transmettre un nom d’utilisateur et recevoir le champ id.
  2. En consultant votre Access Token, vous constaterez que la partie numérique correspond à votre ID utilisateur.
Dans Postman, accédez à l’onglet « Params » et saisissez cet ID utilisateur dans la colonne « Value » du paramètre id.
KeyValue
id2244994945 (user ID)
Troisième étape : Identifier et spécifier les fields que vous souhaitez récupérer Si vous cliquez sur le bouton « Send » après la troisième étape, vous recevrez, dans votre réponse, les fields par défaut du List object : id et name. Si vous souhaitez recevoir des fields supplémentaires au-delà de id et name, vous devrez les spécifier dans votre requête avec les paramètres fields et/ou expansions. Pour cet exercice, nous demanderons trois ensembles supplémentaires de fields provenant d’objets différents :
  • Le field supplémentaire follower_count dans l’objet List principal.
  • Le user object complet en utilisant le paramètre expansions.
  • Le field supplémentaire tweet.created_at dans l’objet utilisateur associé.
Dans Postman, accédez à l’onglet « Params » et ajoutez la paire clé:valeur suivante au tableau « Query Params » :
KeyValueReturned fields
list.fieldsfollower_countfollower_count
expansionsowner_idincludes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fieldscreated_atincludes.users.created_at
Vous devriez maintenant voir une URL similaire à côté du bouton « Send » : https://api.x.com/2/users/2244994945/pinned_lists?expansions=owner_id&list.fields=follower_count&user.fields=created_at Quatrième étape : Envoyer votre requête et examiner la réponse Une fois que tout est configuré, cliquez sur le bouton « Send » ; vous recevrez une réponse similaire à l’exemple suivant : 
{
  "data": [
    {
      "follower_count": 0,
      "id": "1454155907651158017",
      "name": "liste de test",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter Dev"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}
⌘I