Guida all’integrazione

Questa pagina contiene informazioni su diversi strumenti e concetti fondamentali da conoscere durante l’integrazione degli endpoint delle List nel tuo sistema. Abbiamo suddiviso la pagina in alcune sezioni:

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

​

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 in Postman include tutti i parametri di percorso e del corpo per aiutarti a comprendere rapidamente quali opzioni sono disponibili. Per ulteriori informazioni sulle nostre raccolte Postman, visita la pagina “Using Postman”. 

​

Esempi di codice

Vuoi iniziare a usare questo endpoint con del codice nel tuo linguaggio 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 per iniziare. Puoi trovare una libreria compatibile con gli endpoint v2 cercando il tag di versione corretto.

​

Concetti fondamentali

​

Autenticazione

Tutti gli endpoint di X API v2 richiedono di autenticare le richieste con un set di credenziali, detto anche chiavi e token.

Questi endpoint specifici richiedono l’uso del Contesto utente OAuth 1.0a, il che significa che devi utilizzare un set di API Key e Access Tokens utente per effettuare correttamente la richiesta. Gli Access Tokens 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 o autenticare la tua App utilizzando il flusso OAuth a 3 vie.

Tieni presente che OAuth 1.0a può risultare complesso da usare. Se non conosci questo metodo di autenticazione, ti consigliamo di utilizzare una libreria o uno strumento come Postman per autenticare correttamente le tue richieste.  

​

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, creare 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 all’interno della tua App sviluppatore.  

​

Limiti di velocità

Ogni giorno, molte migliaia di sviluppatori inviano richieste alla X API. Per gestire l’elevato volume di traffico, vengono applicati limiti di velocità a ciascun endpoint, che limitano 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 invii 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/lists	POST	300 richieste ogni 15 minuti
/2/lists/:id	DELETE / PUT	300 richieste ogni 15 minuti