Guida rapida

​

Introduzione all’endpoint di ricerca dei blocchi

Questa guida di Avvio rapido ti aiuterà a effettuare la tua prima richiesta all’endpoint di ricerca dei blocchi utilizzando Postman.

Se desideri vedere esempi di codice in lingue diverse, visita il nostro repository GitHub X API v2 sample code.

​

Prerequisiti

Per completare questa guida, avrai bisogno di un set di chiavi e token per autenticare la tua richiesta. Puoi generarli 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 richieste. Assicurati di salvare tutte le credenziali in un luogo sicuro.

​

Passaggi per creare una richiesta di consultazione dei blocchi

​

Passaggio uno: iniziare con uno strumento o una libreria

Esistono diversi strumenti, esempi di codice e librerie che puoi utilizzare per effettuare una richiesta a questo endpoint, ma qui useremo Postman per semplificare il processo.

Per caricare la raccolta X API v2 di Postman nel tuo ambiente, fai clic sul seguente pulsante:

Aggiungi X API v2 a Postman

Una volta caricata la raccolta X API v2 in Postman, vai alla cartella “Blocks” e seleziona “Blocks Lookup”.  

​

Passaggio due: Autenticare la richiesta

Per inviare correttamente una richiesta alla X API, devi verificare di avere le autorizzazioni necessarie. Per questo endpoint, devi autenticare la richiesta utilizzando Contesto utente OAuth 1.0a oppure OAuth 2.0 Authorization Code con PKCE.

In questo esempio useremo il Contesto utente OAuth 1.0a.

Devi aggiungere le tue chiavi e i tuoi token – nello specifico la tua API Key, la Secret API Key, l’Access Token utente OAuth 1.0a e l’Access Token Secret utente OAuth 1.0a – in Postman. Puoi farlo selezionando l’ambiente denominato “X API v2” nell’angolo in alto a destra di Postman e aggiungendo chiavi e token nei campi “initial value” e “current value” (facendo clic sull’icona a forma di occhio accanto al menu a discesa dell’ambiente).

Queste variabili verranno automaticamente inserite nella scheda Authorization della richiesta se hai configurato tutto correttamente.  

​

Passaggio tre: Specifica un utente

Con questo endpoint, devi specificare il tuo id utente oppure l’id utente di un utente autenticato per vedere chi hai bloccato.

In Postman, vai alla scheda “Params” e inserisci questo nome utente nella colonna “Value” della variabile di percorso id (in fondo alla sezione), assicurandoti di non includere spazi prima o dopo i nomi utente.  

Key	Value
id	(il tuo id utente)
max_results	5

​

Passaggio quattro: identifica e specifica quali campi desideri recuperare

Se fai clic sul pulsante “Send” dopo il passaggio tre, riceverai nella risposta i campi predefiniti dell’oggetto utente: id, name e username.

Se desideri ricevere campi aggiuntivi oltre a id, name e username, devi specificarli nella richiesta usando i parametri fields e/o expansions.

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

1. Il campo aggiuntivo user.created_at negli oggetti utente principali.
2. I campi predefiniti dell’oggetto dei Post fissati associati per gli utenti restituiti: id e text.
3. Il campo aggiuntivo tweet.created_at negli oggetti Post associati.

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

Key	Value	Returned fields
user.fields	created_at	user.created_at
expansions	pinned_tweet_id	tweet.id, tweet.text
tweet.fields	created_at	includes.tweets.created_at

Ora dovresti vedere un URL simile con il tuo user ID al posto dell’URL di TwitterDev accanto al pulsante “Send”:

      https://api.x.com/2/users/2244994945/blocking?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at

​

Passaggio cinque: 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": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Supporto Twitter"
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "Twitter"
    },
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "Spaces"
    },
    {
      "pinned_tweet_id": "1293595870563381249",
      "created_at": "2007-05-23T06:01:13.000Z",
      "id": "6253282",
      "username": "XAPI",
      "name": "X API"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-05-03T17:26:09.000Z",
        "id": "1389270063807598594",
        "text": "ora, tutti coloro che hanno 600 o più follower possono ospitare uno Space.\n\nin base a quello che abbiamo appreso, questi account hanno probabilmente una buona esperienza nell'ospitare grazie al loro pubblico esistente. prima di rendere disponibile a tutti la possibilità di creare uno Space, ci stiamo concentrando su alcune cose. 🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2: Early Access rilasciato\n\nOggi abbiamo annunciato l'Early Access ai primi endpoint della nuova X API!\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }

​

Passaggio sei: esegui la paginazione dei risultati

Potresti notare che nella parte inferiore della risposta è presente un oggetto meta. Se hai ricevuto un next_token, ciò indica che c’è un’altra pagina di risultati che possiamo recuperare. Per ottenere la pagina successiva dei risultati, devi prendere il valore del campo next_token e aggiungerlo alla richiesta come valore di un parametro aggiuntivo pagination_token.  

Chiave	Valore
pagination_token	1D3PU6DRII9HEZZZ

Se invii la richiesta dopo aver aggiunto questo parametro aggiuntivo, i cinque risultati successivi verranno restituiti nel payload seguente, poiché nel passaggio tre abbiamo impostato max_results su 5. Puoi continuare a ripetere questo processo finché non vengono restituiti tutti i risultati, ma puoi anche utilizzare il parametro max_results per richiedere fino a 1000 utenti per richiesta, così non dovrai eseguire la paginazione così spesso.