Guide
Guida all’integrazione
Questa pagina contiene informazioni su diversi strumenti e concetti fondamentali che dovresti conoscere durante l’integrazione degli endpoint per la gestione dei Segnalibri nel tuo sistema. Abbiamo suddiviso la pagina in alcune sezioni:
Prima di approfondire alcuni concetti chiave che ti aiuteranno a integrare questo endpoint, ti consigliamo di familiarizzare con:
Postman è un ottimo strumento che puoi utilizzare per testare un endpoint. Ogni richiesta in Postman include tutti i parametri di percorso e del body per aiutarti a comprendere rapidamente ciò che hai a disposizione. Per ulteriori informazioni sulle nostre Postman collections, visita la pagina “Using Postman”.
Vuoi iniziare a usare questo endpoint con codice nel tuo linguaggio preferito? Mettiamo a disposizione diversi esempi di codice che puoi usare come punto di partenza sulla nostra pagina GitHub.
Sfrutta una delle librerie di terze parti delle nostre community per iniziare. Puoi trovare una libreria compatibile con gli endpoint v2 cercando il tag di versione corretto.
Tutti gli endpoint di X API v2 richiedono che tu autentichi le richieste con un set di credenziali, noto anche come chiavi e token.
Questi endpoint specifici richiedono l’uso del flusso OAuth 2.0 Authorization Code con PKCE, il che significa che devi utilizzare un set di chiavi e Access Tokens utente per effettuare correttamente una 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 un Authorize URL.
Tieni presente che OAuth 2.0 può essere 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.
Per ottenere un set di credenziali di autenticazione compatibili con gli 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. Potrai quindi trovare le tue chiavi e token nella tua App sviluppatore.
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 per conto 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 effettui la richiesta può chiamare l’endpoint solo un certo numero di volte su qualsiasi App sviluppatore. È previsto un limite di velocità utente di 180 richieste per finestra di 15 minuti per il metodo GET. Con il metodo GET dell’endpoint di lookup dei Segnalibri riceverai fino a 800 dei tuoi Post più recenti aggiunti ai Segnalibri. Inoltre, è previsto un limite di velocità utente di 50 richieste per 15 minuti per i metodi POST e DELETE.
⌘I