Guida all’integrazione

Questa pagina contiene informazioni su diversi strumenti e concetti chiave da conoscere quando integri gli endpoint mutes nel tuo sistema. Abbiamo suddiviso la pagina in alcune sezioni:

• Strumenti utili
• Concetti chiave
• Autenticazione
• Developer portal, Projects e Apps
• Limiti di velocità
• Fields ed expansions

​

Strumenti utili

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

​

Postman

Postman è un ottimo strumento che puoi usare per testare un endpoint. Ogni richiesta in Postman include tutti i parametri di percorso e di body per aiutarti a capire rapidamente cosa hai a disposizione. Per ulteriori informazioni sulle nostre raccolte Postman, visita la pagina “Using Postman”. 

​

Esempi di codice

Vuoi iniziare a usare questo endpoint con codice nel 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 librerie di terze parti della nostra community per iniziare. Puoi trovare una libreria compatibile con gli endpoint v2 cercando l’apposito tag di versione.

​

Concetti chiave

​

Autenticazione

Tutti gli endpoint della X API v2 richiedono di autenticare le richieste con un set di credenziali, note anche come chiavi e token. Puoi utilizzare il Contesto utente OAuth 1.0a 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 correttamente una richiesta. 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, quest’ultimo deve autorizzare la tua App utilizzando il flusso OAuth a 3 vie.

Tieni presente che OAuth 1.0a può essere complesso da usare. Se non conosci questo metodo di autenticazione, ti consigliamo di utilizzare una libreria o uno strumento come Postman.

​

Developer portal, Projects, and developer Apps

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

​

Limiti di velocità

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

Questi endpoint sono soggetti a limiti di velocità a livello utente, il che significa che l’utente autenticato per conto del quale stai effettuando la richiesta può chiamare l’endpoint solo un numero limitato di volte, indipendentemente dall’App sviluppatore utilizzata. 

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

Endpoint	Metodo HTTP	Limite di velocità
/2/users/:id/pinned_lists	POST	50 richieste ogni 15 minuti
/2/users/:id/pinned_lists/:list_id	DELETE	50 richieste ogni 15 minuti
/2/users/:id/pinned_lists	GET	15 richieste ogni 15 minuti

​

Campi ed expansions

L’endpoint GET di X API v2 consente agli utenti di selezionare esattamente quali dati restituire dall’API utilizzando un insieme di strumenti chiamati fields ed expansions. Il parametro expansions consente di includere nel dettaglio gli oggetti referenziati nel payload. Ad esempio, la ricerca delle List fissate consente di ottenere le seguenti expansions:

• owner_id

Il parametro fields consente di selezionare esattamente quali fields, all’interno dei diversi oggetti di dati, si desidera ricevere. Questo endpoint restituisce principalmente oggetti utente. Per impostazione predefinita, l’oggetto List restituisce i campi id e name. Per ricevere campi aggiuntivi come list.created_at o list.description, è necessario richiederli esplicitamente utilizzando un parametro fields. 

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

Il prospetto seguente mostra i campi e le expansions disponibili per l’endpoint di lookup:

Endpoint	Fields	Expansions
/2/users/:id/pinned_lists	list.fields user.fields	owner_id