Guida all’integrazione

Questa pagina contiene informazioni su diversi strumenti e concetti fondamentali che dovresti conoscere mentre integri nel tuo sistema l’endpoint di ricerca dei Post di una List. Abbiamo suddiviso la pagina in alcune sezioni:

• Strumenti utili
• Concetti chiave
• Autenticazione
• Developer portal, Project e App
• Limiti di velocità
• fields e expansions
• Paginazione

​

Strumenti utili

Prima di approfondire alcuni concetti chiave che ti aiuteranno a integrare questo endpoint, ti consigliamo di familiarizzare con:

​

Postman

Postman è un ottimo strumento che puoi utilizzare per testare un endpoint. Ogni richiesta Postman include tutti i parametri di percorso e del body per aiutarti a comprendere rapidamente ciò che è disponibile. Per ulteriori informazioni sulle nostre raccolte Postman, visita la pagina “Using Postman”. 

​

Esempi di codice

Se desideri configurare questo endpoint utilizzando il tuo linguaggio di programmazione preferito, mettiamo a disposizione diversi esempi di codice che puoi usare come punto di partenza sulla nostra pagina GitHub.

​

Librerie di terze parti

Sfrutta una delle nostre librerie di terze parti sviluppate dalla community per iniziare. Puoi trovare una libreria compatibile con gli endpoint v2 cercando il tag di versione appropriato.

​

Concetti chiave

​

Autenticazione

Tutti gli endpoint di X API v2 richiedono di autenticare le richieste con un set di credenziali, noto anche come chiavi e token. Puoi utilizzare Contesto utente OAuth 1.0a, App only oppure OAuth 2.0 Authorization Code con PKCE per autenticare le richieste a questo endpoint. 

Contesto utente OAuth 1.0a, il che significa che devi utilizzare un set di API Key e Access Tokens utente per effettuare una richiesta con esito positivo. Gli access token devono essere associati all’utente per conto del quale stai effettuando la richiesta. Se desideri generare un set di Access Tokens per un altro utente, è necessario che autorizzi la tua App utilizzando il flusso OAuth a 3 vie.

Tieni presente che OAuth 1.0a può risultare complesso da usare. Se non hai familiarità con questo metodo di autenticazione, ti consigliamo di usare una libreria, uno strumento come Postman o, in alternativa, OAuth 2.0 o App only per autenticare le richieste.

OAuth 2.0 Authorization Code con PKCE consente un controllo più granulare sull’ambito di un’applicazione e flussi di autorizzazione su più dispositivi. OAuth 2.0 ti permette di scegliere scope specifici e dettagliati che conferiscono autorizzazioni precise per conto di un utente. 

Per abilitare OAuth 2.0 nella tua App, devi attivarlo nelle impostazioni di autenticazione della tua App, nella sezione App settings del developer portal.

App only richiede semplicemente di includere un App only Access Token nella richiesta. Puoi generare un App only Access Token direttamente all’interno di un’App sviluppatore oppure generarne uno utilizzando l’endpoint POST oauth2/token.

​

Developer portal, Project e App sviluppatore

Per ottenere un set di credenziali di autenticazione compatibili con gli endpoint della X API v2, devi registrarti per un account sviluppatore, configurare un Project all’interno di tale account e creare un’App sviluppatore all’interno di quel Project. Potrai quindi trovare le tue chiavi e token all’interno della tua App sviluppatore.  

​

Limiti di velocità

Ogni giorno, molte migliaia di sviluppatori effettuano richieste alla X API. Per gestire l’enorme volume di queste richieste, su ogni endpoint vengono applicati dei limiti di velocità che limitano il numero di richieste che puoi effettuare per conto della tua App o di un utente autenticato. 

Questo endpoint è soggetto a limiti di velocità sia a livello di App sia a livello di utente. Il limite a livello di App significa che tu, sviluppatore, puoi effettuare solo un certo numero di richieste a questo endpoint in un determinato periodo di tempo da qualsiasi App (utilizzando oppure l’API Key e la Secret API Key, o il Bearer Token). Il limite a livello di utente significa che l’utente autenticato per conto del quale stai effettuando la richiesta può eseguire una ricerca dei Post in una List solo un numero limitato di volte su qualsiasi App sviluppatore.

La tabella seguente mostra i limiti di velocità per ciascun endpoint.

Endpoint	Metodo HTTP	Limite di velocità
/2/lists/:id/tweets	GET	900 richieste ogni 15 minuti

Fields e expansions

L’endpoint GET della X API v2 consente di selezionare esattamente quali data ottenere dall’API utilizzando un set di strumenti chiamati fields e expansions. Il parametro expansions consente di includere in risposta gli oggetti referenziati nel payload. Ad esempio, la ricerca dei Post in una List consente di ottenere le seguenti expansions:

• author_id

Il parametro fields consente di selezionare esattamente quali fields all’interno dei diversi oggetti di data desideri ricevere. Questo endpoint restituisce principalmente Oggetti Post. Per impostazione predefinita, l’Oggetto Post restituisce i campi id e text. Per ricevere campi aggiuntivi come tweet.created_at o tweet.lang, dovrai richiederli esplicitamente utilizzando un parametro fields. 

Abbiamo aggiunto una guida sull’uso congiunto di fields e expansions al nostro X API v2 data dictionary.

La tabella seguente mostra i fields e le expansions disponibili per l’endpoint di lookup:

Endpoint	Fields	Expansions
/2/lists/:id/tweets	tweet.fields user.fields	author_id

Paginazione

La ricerca dei Post in una List può restituire molti data. Per garantire risultati coerenti e ad alte prestazioni in qualsiasi momento, utilizziamo la paginazione. La paginazione è una funzionalità degli endpoint della X API v2 che restituiscono più risultati di quanti possano essere inclusi in una singola risposta. Quando ciò accade, i data vengono restituiti in una serie di “pagine”. Scopri di più su come paginare tra i risultati.