Cerca Post (recenti)

​

Introduzione all’endpoint dei conteggi recenti dei Post

Questa guida di Avvio rapido ti aiuterà a inviare la tua prima richiesta all’endpoint dei conteggi recenti dei Post utilizzando Postman, uno strumento grafico che consente di inviare richieste HTTP.

Se desideri vedere esempi di codice in diversi linguaggi di programmazione, 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 generare queste chiavi e token seguendo questi passaggi:

• Registrati per un account sviluppatore e attendi l’approvazione.
• Crea un Project e un’App sviluppatore 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 conteggio dei Post recenti

Primo passaggio: inizia con uno strumento o una libreria

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

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

Aggiungi X API v2 a Postman

Una volta caricata la raccolta X API v2 in Postman, vai alla richiesta Post counts > Recent Post counts.

Secondo passaggio: autentica la tua richiesta

Per effettuare correttamente una richiesta alla X API, devi verificare di avere l’autorizzazione. Per questo endpoint, devi autenticare la richiesta con i metodi di autenticazione OAuth 2.0 App-Only.

Devi aggiungere le tue chiavi e token, in particolare l’App Access Token (noto anche come App-only Bearer Token) in Postman. Puoi farlo selezionando l’ambiente denominato “X API v2” nell’angolo in alto a destra di Postman e aggiungendo le tue 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).

Questa variabile verrà automaticamente utilizzata nella scheda Authorization della richiesta se hai eseguito correttamente questa operazione.  

Terzo passaggio: crea una query

Ogni richiesta di conteggio dei Post recenti richiede una singola query. In questo esempio utilizzeremo una query che corrisponde ai Post pubblicati dall’account @XDevelopers. Per questa query usiamo l’operatore from: e lo impostiamo su XDevelopers (case-insensitive):

from:XDevelopers

In Postman, vai alla scheda “Params” e inserisci questo ID, o una stringa di ID del Post separati da una virgola, nella colonna “Value” del parametro ids.

Key	Value	Description
query	from:XDevelopers	Query da inviare all’endpoint di conteggio dei Post recenti

Quarto passaggio (opzionale): specifica la granularità della richiesta

Se fai clic su “Send” dopo il terzo passaggio, otterrai il conteggio dei Post recenti predefinito: per ora negli ultimi sette giorni. Se desideri ottenere il conteggio dei Post recenti per giorno, devi aggiungere il parametro granularity con valore day.

In Postman, vai alla scheda “Params” e inserisci day nella colonna “Value” del parametro granularity.

Key	Value	Description
granularity	day	La granularità dei risultati del conteggio dei Post. Valori possibili: day, hour o minute

Ora dovresti vedere il seguente URL accanto al pulsante “Send”:

https://api.x.com/2/tweets/counts/recent?query=from%3AXDevelopers&granularity=day

Quinto passaggio: effettua la richiesta e verifica la risposta

Una volta configurato tutto, premi “Send” e riceverai la seguente risposta:

{
   "data": [
       {
           "end": "2021-06-16T00:00:00.000Z",
           "start": "2021-06-15T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-17T00:00:00.000Z",
           "start": "2021-06-16T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-18T00:00:00.000Z",
           "start": "2021-06-17T00:00:00.000Z",
           "tweet_count": 2
       },
       {
           "end": "2021-06-19T00:00:00.000Z",
           "start": "2021-06-18T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-20T00:00:00.000Z",
           "start": "2021-06-19T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-21T00:00:00.000Z",
           "start": "2021-06-20T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-22T00:00:00.000Z",
           "start": "2021-06-21T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-23T00:00:00.000Z",
           "start": "2021-06-22T00:00:00.000Z",
           "tweet_count": 2
       }
   ],
   "meta": {
       "total_tweet_count": 6
   }
}