Ricerca delle List fissate

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

​

Passaggi per creare una richiesta di ricerca per una List fissata

Primo passaggio: scegli la raccolta di endpoint List in Postman

Dopo aver caricato in Postman la raccolta X API v2, vai alla cartella “List”, seleziona la cartella “Pinned Lists”, quindi scegli “User’s pinned Lists”.  

Secondo passaggio: identifica e specifica l’utente

Per recuperare la List fissata di un utente, devi specificare lo user ID nella richiesta. Lo user ID deve corrispondere all’ID dell’utente che esegue l’autenticazione, il che significa che devi inviare gli Access Tokens associati allo user ID quando autentichi la richiesta. In questo esempio, puoi indicare l’ID del tuo utente. Puoi trovare il tuo ID in due modi:

1. Utilizzando l’endpoint users lookup by username, puoi passare uno username e ricevere il campo id.
2. Nel tuo Access Token, la parte numerica corrisponde al tuo user ID.

In Postman, vai alla scheda “Params” e inserisci questo user ID nella colonna “Value” del parametro id.

Key	Value
id	2244994945 (user ID)

Terzo passaggio: identifica e specifica quali fields desideri recuperare

Se fai clic sul pulsante “Send” dopo il terzo passaggio, riceverai i fields predefiniti del List object nella risposta: id e name.

Se desideri ricevere fields aggiuntivi oltre a id e name, devi specificarli nella richiesta con i parametri field e/o expansion.

Per questo esercizio, richiederemo tre set aggiuntivi di fields da oggetti diversi:

• Il field aggiuntivo follower_count nel List object primario.
• Il user object completo utilizzando il parametro expansion.
• Il field aggiuntivo tweet.created_at nell’oggetto utente associato.

In Postman, vai alla scheda “Params” e aggiungi la seguente coppia chiave:valore alla tabella “Query Params”:

Key	Value	Returned fields
list.fields	follower_count	follower_count
expansions	owner_id	includes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fields	created_at	includes.users.created_at

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

https://api.x.com/2/users/2244994945/pinned_lists?expansions=owner_id&list.fields=follower_count&user.fields=created_at

Quarto passaggio: invia la richiesta e rivedi la risposta

Una volta impostato tutto, premi il pulsante “Send” e riceverai una risposta simile al seguente esempio:

{
  "data": [
    {
      "follower_count": 0,
      "id": "1454155907651158017",
      "name": "lista di prova",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter Dev"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}