Vai al contenuto principale

​
Come integrare gli endpoint dei conteggi dei Post

Questa pagina contiene informazioni su diversi strumenti e concetti chiave da tenere presenti durante l’integrazione nel tuo sistema degli endpoint dei conteggi dei Post recenti o dell’archivio completo. Abbiamo suddiviso la pagina nelle seguenti sezioni:

​
Strumenti utili

Prima di iniziare a esplorare alcuni concetti chiave, consigliamo di usare uno dei seguenti strumenti o esempi di codice per iniziare a testare le funzionalità di questi endpoint.

​
Esempi di codice

Vuoi iniziare a usare questi endpoint con codice nel tuo linguaggio di programmazione preferito? Abbiamo diversi esempi di codice che puoi usare come punto di partenza sulla nostra pagina GitHub, incluso un client Python.

​
Librerie

Sfrutta una delle nostre numerose librerie di terze parti della community per iniziare. Puoi trovare una libreria compatibile con gli endpoint v2 cercando l’apposito tag di versione.

​
Postman

Postman è uno strumento eccellente che puoi utilizzare per testare questi endpoint. Ogni richiesta Postman include tutti i parametri dell’endpoint in questione per aiutarti a capire rapidamente quali opzioni hai a disposizione. Per ulteriori informazioni sulle nostre raccolte Postman, visita la pagina Using Postman.  

​
Concetti fondamentali

​
Autenticazione

Tutti gli endpoint di X API v2 richiedono che le richieste siano autenticate con un set di credenziali, note anche come chiavi e token. Questo endpoint specifico richiede l’uso di OAuth 2.0 Bearer Token, il che significa che devi includere un Bearer Token per effettuare correttamente la richiesta. Puoi generare un Bearer Token direttamente all’interno di un’App sviluppatore oppure generarne uno utilizzando l’endpoint POST oauth2/token.

​
Developer portal, Project e App sviluppatore

Per utilizzare qualsiasi endpoint della X API v2, devi avere un account sviluppatore, configurare un Project all’interno di tale account e creare un’App sviluppatore all’interno di quel Project. Le chiavi e i token di quell’App sviluppatore funzioneranno con gli endpoint dei conteggi dei Post recenti. Se desideri utilizzare l’endpoint dei conteggi dei Post dell’archivio completo o sfruttare gli operatori avanzati e una query più lunga, dovrai essere approvato per l’accesso Enterprise. Visita la nostra sezione sull’accesso Enterprise per saperne di più.

​
Limiti di velocità

Ogni giorno, molte migliaia di sviluppatori inviano richieste alla X API. Per gestire il volume, su ciascun endpoint vengono applicati limiti di velocità che restringono il numero di richieste che ogni sviluppatore può effettuare per conto di un’App o di un utente autenticato. Questo endpoint è soggetto a limiti di velocità a livello di App, il che significa che tu, sviluppatore, puoi effettuare solo un determinato numero di richieste a questo endpoint in un dato intervallo di tempo da qualsiasi App (come determinato dalle credenziali che stai utilizzando). 

​
Creazione di query

La funzionalità centrale di questi endpoint è l’uso di un’unica query per filtrare i Post nei conteggi che ti vengono recapitati. Le query sono composte da operatori che fanno corrispondere attributi di Post e utenti, come parole chiave del messaggio, hashtag e URL. Gli operatori possono essere combinati in query con logica booleana e parentesi per affinare il comportamento di corrispondenza della query. Puoi consultare la nostra guida su come creare una query per saperne di più. Per i conteggi dei Post recenti non viene restituito alcun next_token, il che significa che, indipendentemente dalla granularità, otterrai il volume dei Post degli ultimi 7 giorni in un’unica chiamata API. Per i conteggi dei Post dell’archivio completo otterrai i dati degli ultimi 30 giorni. Per i dati oltre i 30 giorni, riceverai un next_token che potrai utilizzare per paginare e ottenere i dati aggiuntivi. 

​
Creazione di query per i conteggi dei Post

Gli endpoint per i conteggi dei Post accettano una singola query tramite una richiesta GET e restituiscono un set di conteggi storici dei Post che corrispondono alla query. Le query sono costituite da operatori utilizzati per corrispondere a una varietà di attributi dei Post. 

​
Indice

⌘I