Gérer les Listes épinglées

Épingler et désépingler des Listes

Ce guide vous explique comment épingler et désépingler des listes.

Prérequis

Avant de commencer, vous aurez besoin :

• D’un compte développeur avec une App approuvée
• D’un jeton d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

---

​

Épingler une Liste

1. Récupérer l’ID de votre utilisateur et l’ID de la Liste

   Vous avez besoin de l’ID de votre utilisateur authentifié et de l’ID de la liste que vous voulez épingler. Vous pouvez trouver les ID de liste dans l’URL lorsque vous affichez une liste.

2. Épingler la Liste

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/2244994945/pinned_lists" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"list_id": "1454155907651158017"}'
   
3. Vérifier la réponse

   {
     "data": {
       "pinned": true
     }
   }
   

---

​

Détacher une Liste

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/pinned_lists/1454155907651158017" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Réponse :

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

---

​

Notes importantes

• Seules les Listes que vous suivez ou que vous possédez peuvent être épinglées
• Les Listes épinglées apparaissent en haut de vos Listes dans l’app X
• Il y a une limite au nombre de Listes que vous pouvez épingler

---

​

Étapes suivantes

Recherche de listes épinglées

Obtenez vos listes épinglées

Recherche de liste

Obtenez les détails de la liste

Référence de l’API

Documentation complète de l’endpoint