Gérer les Listes épinglées

Remarque : Ce guide suppose que vous avez rempli les prérequis présentés dans la vue d’ensemble « Bien démarrer ».

​

Étapes pour créer une requête de gestion des List épinglées

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 “Pin a List”.  

Deuxième étape : spécifier la List à épingler

Les endpoints de gestion des List épinglées requièrent deux ID : un pour l’utilisateur (l’utilisateur authentifié qui épingle une List) et un pour la List cible (la List à épingler). L’ID de l’utilisateur doit correspondre à l’ID de l’utilisateur authentifié, ce qui signifie que vous devez transmettre les Access Tokens associés à cet ID utilisateur lors de l’authentification de votre requête. Dans ce cas, 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.

L’ID de la List cible peut être celui de n’importe quelle List valide. Dans Postman, accédez à l’onglet “Params” et saisissez l’ID utilisateur dans la colonne “Value” de la variable de chemin id. Accédez ensuite à l’onglet “Body” et saisissez l’ID de la List que vous souhaitez épingler comme valeur du paramètre list_id. Veillez à ne pas inclure d’espaces avant ou après un ID.

Key	Value	Parameter type
id	L’ID utilisateur	path
list_id	L’ID de la List cible à épingler	body

Vous devriez maintenant voir une URL similaire à côté du bouton “Send” :

      https://api.x.com/2/users/2244994945/pinned_lists

Étape trois : Envoyez votre requête et examinez 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": {
    "pinned": true
  }
}

Vous avez épinglé la List cible avec succès si l’objet de réponse renvoyé contient la valeur true pour la clé pinned.

Pour désépingler une List, sélectionnez la requête « Unpin List » également située dans le dossier « Lists » de la collection X API v2 chargée dans Postman. Cet endpoint requiert l’id de l’utilisateur authentifié et l’id de la List à désépingler. Dans l’onglet « Params », saisissez l’id utilisateur comme valeur de la colonne id et l’id de la List à désépingler comme valeur de la colonne list_id.

En cas de requête DELETE réussie, vous recevrez une réponse similaire à l’exemple suivant :

{
  "data": {
    "pinned": false
  }
}