Vai al contenuto principale
Questa pagina contiene informazioni su vari strumenti e concetti chiave per aiutarti a integrare gli endpoint di lookup dei Post nel tuo sistema. Abbiamo organizzato la pagina in alcune sezioni:

​
Strumenti utili

Prima di approfondire alcuni concetti chiave, consigliamo di familiarizzare con i seguenti strumenti: Postman
Postman è un ottimo strumento per testare un endpoint, includendo tutti i parametri di percorso e del body, per aiutarti a capire cosa è disponibile. Consulta la nostra guida introduttiva a Postman per saperne di più. Esempi di codice
Trova esempi di codice per il tuo linguaggio di programmazione preferito sulla nostra pagina GitHub. Librerie di terze parti
Usa librerie di terze parti sviluppate dalla community, compatibili con gli endpoint v2.

​
Concetti chiave

​
Autenticazione

Tutti gli endpoint di X API v2 richiedono richieste autenticate. Puoi autenticarti con:
OAuth 1.0a può essere complesso da implementare. Se non ti è familiare, valuta l’uso di una libreria o di OAuth 2.0 per le richieste. Per metriche private o Post, utilizza Contesto utente OAuth 1.0a o OAuth 2.0 Authorization Code con PKCE.
Nota bene
Se richiedi i seguenti fields, è necessario Contesto utente OAuth 1.0a o OAuth 2.0 Authorization Code:
  • 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

Per ottenere le credenziali per la X API v2, ti servono:
  1. Un account sviluppatore approvato.
  2. Un Project all’interno dell’account sviluppatore.
  3. Un’App sviluppatore all’interno di quel Project, dove è possibile trovare chiavi e token.

​
Limiti di velocità

Le richieste alla X API sono soggette a limiti di velocità per gestire il volume. I limiti si applicano sia a livello di App sia a livello di utente:
  • A livello di App: limita il numero di richieste effettuate in un determinato periodo da qualsiasi App.
  • A livello di utente: limita la frequenza con cui un utente autenticato può eseguire lookup di Post tra le App sviluppatore.

​
Campi ed expansions

La X API v2 consente di selezionare specifici campi dati utilizzando fields e expansions:
  • Expansions: Consentono di recuperare oggetti correlati aggiuntivi. Le expansions supportate includono:
    • edit_history_tweet_ids
    • 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
  • Fields: Specificano i campi dati all’interno degli oggetti per restituire informazioni aggiuntive. L’Oggetto Post include per impostazione predefinita id, text ed edit_history_tweet_ids. Altre opzioni, come tweet.created_at e tweet.entities, devono essere richieste esplicitamente.
Per maggiori dettagli, consulta la guida su fields ed expansions nel dizionario dei dati di X API v2.

​
Modifiche ai Post

I Post idonei possono essere modificati fino a cinque volte entro 30 minuti dalla pubblicazione. L’endpoint di ricerca dei Post fornisce sempre la versione più recente del Post. Per i casi d’uso quasi in tempo reale, tenere presente questa finestra temporale. Per ulteriori dettagli, consultare Fondamenti della modifica dei Post.

​
Casi limite

  • Metriche promosse: La richiesta di metriche promosse per Post non promossi restituisce una risposta vuota.
  • Testo troncato: Il testo del Post viene troncato nei Retweet. Per ottenere il testo completo, espandere il Post di riferimento.
⌘I