Gestire le List fissate

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

​

Passaggi per creare una richiesta di gestione delle List fissate

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 cartella “Pinned Lists”, quindi scegli “Pin a List”.  

Secondo passaggio: specifica la List da fissare

Gli endpoint per la gestione delle List fissate richiedono due ID: uno per l’utente (l’utente autenticato che fissa una List) e uno per la List di destinazione (la List da fissare). L’ID dell’utente deve corrispondere all’ID dell’utente che esegue l’autenticazione, il che significa che devi passare gli Access Tokens associati all’ID utente quando esegui l’autenticazione della richiesta. In questo caso, puoi specificare l’ID appartenente al tuo utente. Puoi trovare il tuo ID in due modi:

1. Utilizzando l’endpoint users lookup by username, puoi passare un username e ricevere il campo id.
2. Guardando il tuo Access Token, vedrai che la parte numerica corrisponde al tuo ID utente.

L’ID della List di destinazione può essere quello di qualsiasi List valida. In Postman, vai alla scheda “Params” e inserisci l’ID utente nella colonna “Value” della variabile di percorso id. Vai alla scheda “Body” e inserisci l’ID della List che desideri fissare come valore per il parametro list_id. Assicurati di non includere spazi prima o dopo qualsiasi ID.

Key	Value	Parameter type
id	L’ID utente	path
list_id	L’ID della List di destinazione da fissare	body

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

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

Fase 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:

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

Hai bloccato in alto la List di destinazione se l’oggetto di risposta contiene il valore true per la chiave pinned. 

Per rimuovere il pin da una List, seleziona la richiesta “Unpin List” presente anche nella cartella “Lists” della raccolta X API v2 caricata in Postman. Questo endpoint richiede l’ID dell’utente autenticato e l’ID della List da cui rimuovere il pin. Nella scheda “Params”, inserisci l’ID utente come valore per la colonna id e l’ID della List da cui rimuovere il pin come valore per la colonna list_id. 

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

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