Introduzione

Il gruppo di endpoint di X Activity API (XAA) consente agli sviluppatori di accedere agli eventi di attività che si verificano sulla piattaforma X.

Gli sviluppatori possono sottoscrivere gli eventi di loro interesse, come ProfileBioUpdate, ProfilePictureUpdate ecc., e filtrare in base all’User ID per cui desiderano ricevere gli eventi. Gli eventi corrispondenti per quell’User ID saranno recapitati alla tua app con una latenza inferiore al secondo.

X Activity API è disponibile in open beta. Durante l’open beta, prevedi potenziali bug, modifiche non retrocompatibili o funzionalità incomplete.

Il tuo feedback è prezioso: segnala eventuali problemi tramite i nostri forum della community per sviluppatori.

​

Meccanismi di recapito

L’API X Activity supporta attualmente i seguenti meccanismi di recapito per inviare eventi alla tua app:

• Flusso HTTP persistente
• Webhook

​

Tipi di evento supportati

Attualmente, la X Activity API supporta i seguenti eventi di aggiornamento del profilo:

Categoria	Nome evento	Descrizione
Profilo	ProfileBioUpdate	Attivato quando un utente aggiorna la biografia del proprio profilo
Profilo	ProfilePictureUpdate	Attivato quando un utente aggiorna l’immagine del profilo
Profilo	ProfileBannerUpdate	Attivato quando un utente aggiorna il banner del profilo
Profilo	ProfileGeoUpdate	Attivato quando un utente aggiorna la posizione del profilo
Profilo	ProfileUrlUpdate	Attivato quando un utente aggiorna l’URL del sito web del profilo
Profilo	ProfileScreennameUpdate	Attivato quando un utente aggiorna il nome visualizzato
Profilo	ProfileVerifiedBadgeUpdate	Attivato quando un utente aggiorna il badge di verifica

Nelle versioni future, XAA verrà ampliata per supportare ulteriori tipi di eventi, tra cui interazioni social, coinvolgimento dei contenuti, funzionalità di monetizzazione e altro. Continueremo ad aggiornare la documentazione quando saranno disponibili nuovi tipi di eventi.

Nota: XAA non recapita Post. Per la consegna in tempo reale dei Post, consulta il nostro endpoint Filtered Stream, che consente agli sviluppatori di filtrare e trasmettere Post in tempo reale.

​

Privacy degli eventi e autenticazione

L’API X Activity distingue tra eventi pubblici ed eventi privati in modo coerente con l’app X, come spiegato di seguito.

​

Eventi pubblici

Gli eventi pubblici sono le attività che un account utente pubblico svolge in modo pubblico e che sono visibili a tutti gli utenti di X. Questi eventi sono accessibili a tutti sulla piattaforma X e non richiedono l’autenticazione OAuth dell’utente per essere visualizzati.

Eventi pubblici attuali:

• Aggiornamenti del profilo (bio, immagine, banner, località, URL, modifiche al nome utente)

Per questi eventi pubblici puoi creare sottoscrizioni specificando l’id utente nel filtro e riceverli tramite XAA.

​

Eventi privati

Gli eventi privati sono attività che richiedono il consenso esplicito dell’utente tramite autenticazione OAuth. Un utente deve autenticarsi con X e concedere un’autorizzazione esplicita a un’App per sviluppatori per accedere a questi eventi.

Requisiti di autenticazione per gli eventi privati:

• L’utente deve autenticare la tua applicazione tramite OAuth 2.0
• La tua applicazione deve ottenere gli scope OAuth appropriati
• L’utente deve concedere esplicitamente l’autorizzazione alla tua app per accedere a questi eventi
• Le sottoscrizioni agli eventi privati possono essere create solo per gli utenti che hanno autorizzato la tua applicazione

​

Limiti di abbonamento

La X Activity API prevede limiti di abbonamento diversi in base al tuo livello di account:

Pacchetto	Abbonamenti massimi
Free	Non disponibile
Basic	50
Pro	2500
Enterprise	20.000
Partner	100.000

Configurazione dell’account

Per accedere a questi endpoint, avrai bisogno di:

• Un account sviluppatore approvato.
• Di autenticarti utilizzando le chiavi e i token di un’App per sviluppatori che si trova all’interno di un Project. 

Scopri di più su come ottenere l’accesso agli endpoint di X API v2 nella nostra guida introduttiva.