Vai al contenuto principale

​
Guida introduttiva all’endpoint di ricerca dei Post della List

Questa guida di Avvio rapido ti aiuterà a inviare la tua prima richiesta all’endpoint di ricerca dei Post della List utilizzando Postman. Visita il nostro repository GitHub X API v2 sample code se vuoi vedere esempi di codice in diverse lingue.

​
Prerequisiti

Per completare questa guida, devi disporre di un set di chiavi e token per autenticare la tua richiesta. Puoi generare queste chiavi e questi token seguendo questi passaggi:
  • Registrati per un account sviluppatore e attendi l’approvazione.
  • Crea un Project e una developer App associata nel developer portal.
  • Vai alla pagina “Keys and tokens” della tua App per generare le credenziali necessarie. Assicurati di salvare tutte le credenziali in un luogo sicuro.

​
Passaggi per creare una richiesta di lookup dei Post di una List

​
Passaggio uno: iniziare con uno strumento o una libreria

Esistono diversi strumenti, esempi di codice e librerie che puoi utilizzare per inviare una richiesta a questo endpoint, ma qui useremo Postman per semplificare il processo. Per importare la raccolta Postman di X API v2 nel tuo ambiente, fai clic sul seguente pulsante:
Una volta importata la raccolta X API v2 in Postman, vai alla cartella “List”, seleziona la cartella “List Posts”, quindi scegli “List Posts lookup”.  

​
Passaggio due: Autentica la tua richiesta

Per effettuare correttamente una richiesta alla X API, devi verificare di avere l’autorizzazione. Per farlo con questo endpoint, devi autenticare la richiesta con uno dei seguenti metodi: App only, OAuth 2.0 Authorization Code con PKCE oppure Contesto utente OAuth 1.0a. Per semplicità useremo App only per questa richiesta, ma se desideri ottenere metriche o Post privati, dovrai utilizzare uno degli altri metodi di autenticazione. Per utilizzare App only, devi aggiungere le tue chiavi e token (in particolare l’App only Access Token, noto anche come App only Bearer Token) in Postman selezionando l’ambiente denominato “X API v2” (nell’angolo in alto a destra di Postman) e aggiungendo le chiavi e i token ai campi “initial value” e “current value” (facendo clic sull’icona a forma di occhio accanto al menu a discesa dell’ambiente). Se l’hai fatto correttamente, queste variabili verranno importate automaticamente nella scheda Authorization della richiesta.  

​
Terzo passaggio: identifica e specifica da quale List desideri recuperare i Post

Devi specificare una List da cui desideri ricevere i Post all’interno della richiesta. Puoi trovare l’id della List navigando su x.com, facendo clic su una List e poi controllando l’URL. Ad esempio, l’id della List nel seguente URL è 84839422. https://x.com/i/lists/84839422 L’id di destinazione può essere qualsiasi id di List valido. In Postman, vai alla scheda “Params” e inserisci il tuo id nella colonna “Value” della variabile di percorso id. Assicurati di non includere spazi prima o dopo alcun id.
KeyValue
id84839422 (The List ID)

​
Passaggio quattro: identifica e specifica quali campi desideri recuperare

Se fai clic sul pulsante “Send” dopo il passaggio tre, riceverai i campi predefiniti dell’Oggetto Post nella tua risposta: id e text. Se desideri ricevere campi aggiuntivi, dovrai specificarli nella tua richiesta con i parametri tweet.fields e/o expansions. Per questo esercizio, richiederemo tre insiemi aggiuntivi di campi da oggetti diversi:
  • Il campo aggiuntivo created_at nell’oggetto List principale.
  • L’oggetto utente completo utilizzando il parametro di expansion
  • Il campo aggiuntivo user.created_at nell’oggetto utente associato.
In Postman, vai alla scheda “Params” e aggiungi la seguente coppia key:value alla tabella “Query Params”:
KeyValueReturned fields
tweet.fieldscreated_atcreated_at
expansionsauthor_idincludes.users.id,
includes.users.name,
includes.users.username
user.fieldscreated_atincludes.users.created_at
Ora dovresti vedere un URL simile accanto al pulsante “Send”: https://api.x.com/2/lists/84839422/tweets?expansions=author_id&user.fields=created_at&max_results=1

​
Passaggio cinque: Invia la richiesta e rivedi la risposta

Una volta configurato tutto, fai clic sul pulsante “Send” e riceverai una risposta simile al seguente esempio: 
{
  "data": [
    {
      "author_id": "4172587277",
      "id": "1458172421115101189",
      "text": "La Germania ha registrato questa settimana un record di nuovi casi di Covid-19. Secondo il governo e gli esperti sanitari, le persone non vaccinate sono responsabili della situazione \nhttps://t.co/4POyaPwMLu"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "MomentsBrasil",
        "name": "X Moments Brasil",
        "created_at": "2015-11-12T16:46:02.000Z",
        "id": "4172587277"
      }
    ]
  },
  "meta": {
    "result_count": 1,
    "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
  }
}
Nota: La risposta di questo endpoint supporterà l’esecuzione di query sugli ultimi 800 Post per una determinata List
⌘I