Gérer les membres de List

​

Guide de démarrage rapide pour gérer les membres d’une List

Remarque : Ce guide suppose que vous avez réalisé les prérequis de la vue d’ensemble du démarrage rapide.

​

Étapes pour créer une requête de gestion des membres d’une List

​

Première étape : choisissez la collection d’endpoints List dans Postman

Une fois la collection X API v2 chargée dans Postman, accédez au dossier « List », sélectionnez le sous-dossier « List members », puis choisissez « Add a member ».  

​

Deuxième étape : spécifier l’utilisateur à ajouter

Les endpoints de gestion des membres de List nécessitent deux ID : l’ID de la List et l’ID de l’utilisateur à ajouter. Vous pouvez trouver l’ID de l’utilisateur à l’aide de la recherche d’utilisateurs en transmettant un nom d’utilisateur pour obtenir le champ id.

L’ID cible peut être n’importe quel ID d’utilisateur valide. Dans Postman, accédez à l’onglet « Params », puis saisissez votre ID dans la colonne « Value » de la variable de chemin id. Accédez à l’onglet « Body » et indiquez l’ID de l’utilisateur que vous souhaitez ajouter comme valeur du paramètre user_id. Veillez à ne pas inclure d’espaces avant ou après un ID.

Key	Value	Parameter type
id	L’ID de la List	path
user_id	L’ID de l’utilisateur cible que vous souhaitez ajouter en tant que membre	body

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

https://api.x.com/2/lists/1441162269824405510/members

Troisième étape : envoyer votre requête et examiner votre réponse

Une fois que tout est en place, cliquez sur le bouton « Send », et vous recevrez une réponse similaire à l’exemple suivant :

{
  "data": {
    "is_member": true
  }
}

Si l’objet de réponse retourné contient la valeur true pour la clé is_member, vous avez bien ajouté l’utilisateur comme membre de la List.

Pour retirer un membre d’une List, sélectionnez la requête « Remove a member » également située dans le dossier « Lists » de la collection X API v2 chargée dans Postman. Cet endpoint nécessite l’id de la List et l’id utilisateur du membre que vous souhaitez retirer. Dans l’onglet « Params », saisissez l’id de la List comme valeur de la colonne id et l’id de l’utilisateur à retirer comme valeur de la colonne user_id.

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

{
  "data": {
    "is_member": false
  }
}