Gestire i membri della List

​

Guida rapida per gestire i membri delle List

Nota: Questa guida presuppone che tu abbia completato i prerequisiti nella panoramica di Avvio rapido.

​

Passaggi per creare una richiesta per gestire i membri di una List

​

Primo passaggio: scegli la raccolta di endpoint List in Postman

Una volta caricata la raccolta X API v2 in Postman, vai alla cartella “List”, seleziona la sottocartella “List members”, quindi scegli “Add a member”.  

​

Passo due: specificare l’utente da aggiungere

Gli endpoint per la gestione dei membri di una List richiedono due ID: l’ID della List e l’ID dell’utente da aggiungere. Puoi trovare l’ID dell’utente usando il users lookup e passando un username per ottenere il campo id.

L’ID di destinazione può essere qualsiasi ID utente valido. In Postman, vai alla scheda “Params” e inserisci il tuo ID nella colonna “Value” della variabile di percorso id. Vai alla scheda “Body” e inserisci l’ID dell’utente che desideri aggiungere come valore del parametro user_id. Assicurati di non includere spazi prima o dopo alcun ID.

Key	Value	Parameter type
id	L’ID della List	path
user_id	L’ID dell’utente di destinazione che desideri aggiungere come membro	body

Ora dovresti vedere un URL simile accanto al pulsante “Send”:

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

Passo tre: invia la richiesta e verifica la risposta

Una volta configurato tutto, fai clic sul pulsante “Send” e riceverai una risposta simile al seguente esempio di risposta:

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

Se l’oggetto di risposta restituito contiene il valore true per la chiave is_member, l’utente è stato aggiunto correttamente come membro della List. 

Per rimuovere un membro da una List, seleziona la richiesta “Remove a member”, anch’essa presente nella cartella “Lists” della raccolta X API v2 caricata in Postman. Questo endpoint richiede l’ID della List e l’ID utente del membro che desideri rimuovere. Nella scheda “Params”, inserisci l’ID della List come valore della colonna id e l’ID dell’utente da rimuovere come valore della colonna user_id. 

Se la richiesta DELETE va a buon fine, riceverai una risposta simile al seguente esempio:

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