Vai al contenuto principale
Questa pagina contiene informazioni su vari strumenti e concetti chiave da conoscere quando integri gli endpoint di Retweet nel tuo sistema. Abbiamo suddiviso la pagina in alcune sezioni:

​
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 per testare un endpoint. Ogni richiesta in Postman include tutti i parametri di percorso e del corpo per aiutarti a capire rapidamente quali opzioni hai a disposizione. Per ulteriori informazioni sulle nostre collection di Postman, visita la pagina “Using Postman”. 

​
Esempi di codice

Vuoi iniziare a usare questo endpoint con del codice nel tuo linguaggio preferito? Abbiamo 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 il tag di versione corretto.  

​
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 oppure l’OAuth 2.0 Bearer Token per autenticare le richieste all’endpoint di lookup dei Retweet. Gli endpoint per la gestione dei Retweet richiedono il Contesto utente OAuth 1.0a; ciò significa che devi usare un set di API Key e access token utente per effettuare correttamente la richiesta. Gli access token devono essere associati all’utente per conto del quale stai effettuando la richiesta. Se desideri generare un set di access token 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ò essere complesso da usare. Se non hai familiarità con questo metodo di autenticazione, ti consigliamo di utilizzare una libreria per autenticare correttamente le richieste. Nota bene Se richiedi i seguenti fields, è necessario il Contesto utente OAuth 1.0a:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
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 in quel Project. Potrai quindi trovare le tue chiavi e token nella tua App sviluppatore.   

​
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 definiscono il numero di richieste che puoi effettuare per conto della tua App o di un utente autenticato. Gli endpoint per la gestione dei Retweet sono limitati a 50 richieste ogni 15 min (per utente). Inoltre, per l’endpoint POST, il limite è di 300 richieste per finestra di 3 ore (per utente, per App). Con l’endpoint di lookup dei Retweet, il limite è di 75 richieste per finestra di 15 min. Inoltre, questo endpoint restituirà solo i 100 utenti che hanno eseguito il Retweet più di recente.

​
Campi ed expansions

La X API v2 consente di selezionare con precisione quali data restituire dall’API utilizzando un insieme di strumenti chiamati fields ed expansions. Il parametro expansions consente di includere nel response gli oggetti referenziati nel payload. Ad esempio, questo endpoint consente di richiamare le seguenti expansions:
  • attachments.poll_ids
  • attachments.media_keys
  • author_id, entities.mentions.username
  • geo.place_id
  • in_reply_to_user_id,
  • referenced_tweets.id,
  • referenced_tweets.id.author_id
Il parametro fields consente di selezionare esattamente quali fields all’interno dei diversi oggetti data si desidera ricevere. Questi endpoint restituiscono 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.entities, è necessario richiederli esplicitamente utilizzando un parametro fields. Alcuni campi importanti da considerare nella tua integrazione sono i dati dei sondaggi, le metriche, le annotations del Post e i campi conversation ID. Abbiamo aggiunto al nostro X API v2 data dictionary una guida su come usare fields ed expansions insieme.
⌘I