Home timeline in ordine cronologico inverso
Cronologia dei Post dell’utente
L’endpoint della cronologia dei Post dell’utente consente di accedere ai Post pubblicati da uno specifico account X. Recuperare i Post di un utente permette di creare esperienze come mostrare una timeline in un’interfaccia utente, analizzare i Post per comprenderne meglio i contenuti oppure creare flussi di lavoro di engagement con i suoi Post in modo programmatico. Questo endpoint fornisce accesso ai Post, ai Retweet, alle risposte e ai Quote Tweet più recenti di un singolo account X, analogamente a quanto visibile nella timeline del profilo di un utente. Ecco una timeline utente per @XDevelopers: L’endpoint della cronologia dei Post dell’utente è un endpoint REST che accetta un singolo parametro di percorso per indicare l’utente desiderato (tramite ID utente). L’endpoint può restituire fino a 3.200 tra Post, Retweet, risposte e Quote Tweet pubblicati dall’utente, a partire dai più recenti. I Post vengono restituiti in ordine cronologico inverso, a partire dai più recenti. I risultati sono paginati fino a 100 Post per pagina. Sono forniti token di paginazione per scorrere insiemi di Post di grandi dimensioni. Gli ID del Post più recente e più vecchio inclusi nella pagina sono forniti come metadata e possono essere usati anche per effettuare il polling delle timeline per recuperare Post recenti. La cronologia dei Post dell’utente supporta inoltre i parametri start_time ed end_time per ricevere i Post creati entro una specifica finestra temporale. L’endpoint della cronologia dei Post dell’utente supporta i parametri fields e expansions e restituisce il nuovo formato di dati JSON. Per effettuare correttamente una richiesta a questo endpoint, devi autorizzarla con i metodi di autenticazione OAuth 1.0a User Context, OAuth 2.0 Authorization Code con PKCE o OAuth 2.0 App-Only. Devi utilizzare OAuth 1.0a User Context o OAuth 2.0 Authorization Code con PKCE quando richiedi metriche non pubbliche, metriche promosse o la timeline di un utente protetto. L’endpoint della cronologia dei Post dell’utente è progettato per supportare due modelli d’uso comuni:- “Recuperare i Post storici di un utente”: richieste effettuate alla cronologia dei Post dell’utente per ricevere i Post creati dall’utente di interesse in ordine cronologico all’interno di un intervallo di tempo recente specifico. L’intervallo temporale può essere impostato usando start_time ed end_time e paginando attraverso tutti i risultati. In alcuni casi, l’intera cronologia dei Post di un utente può essere recuperata se l’utente ha pubblicato fino a 3.200 Post sul proprio account. I Post inclusi dipendono dalla loro disponibilità pubblica e dal metodo di autenticazione utilizzato per le richieste.
- “Polling per nuovi Post”: richieste effettuate alla cronologia dei Post dell’utente in modo continuativo, per recuperare nuovi Post creati da un utente specifico. L’ultimo ID del Post ricevuto può essere impostato come parametro per qualsiasi nuova richiesta successiva all’ultimo Post.
Cronologia delle menzioni dell’utente
L’endpoint della cronologia delle menzioni dell’utente consente di richiedere Post che menzionano uno specifico utente X, ad esempio se un account X ha menzionato @XDevelopers all’interno di un Post. Include anche le risposte ai Post dell’utente richiesto. Recuperare le menzioni di un utente consente di creare esperienze come scoprire rapidamente chi risponde ai Post dell’utente, chi lo menziona o creare flussi di lavoro di engagement con i suoi Post in modo programmatico. L’endpoint consente di richiedere le menzioni e le risposte più recenti di un singolo utente, in modo simile a quanto visibile nelle notifiche per le menzioni di un utente su X. La cronologia delle menzioni dell’utente è un endpoint REST che accetta un singolo parametro di percorso per indicare l’utente desiderato (tramite ID utente). L’endpoint può restituire fino a 800 menzioni più recenti per tale utente. I Post vengono restituiti in ordine cronologico inverso, a partire dal più recente. I risultati sono paginati fino a 100 Post per pagina. Vengono forniti token di paginazione per scorrere insiemi di Post di grandi dimensioni. Gli ID del Post più recente e di quello meno recente inclusi nella pagina sono forniti come metadata; possono essere utilizzati per effettuare il polling delle timeline alla ricerca di Post recenti o per navigare nella timeline, in modo simile all’endpoint v1.1 mentions_timeline. L’endpoint supporta inoltre i parametri start_time ed end_time per ricevere Post creati entro una determinata finestra temporale. Per inviare correttamente una richiesta a questo endpoint, è necessario autorizzarla con i metodi di autenticazione Contesto utente OAuth 1.0a, OAuth 2.0 Authorization Code con PKCE o OAuth 2.0 App-Only. Devi utilizzare Contesto utente OAuth 1.0a o OAuth 2.0 Authorization Code con PKCE quando richiedi metriche non pubbliche, metriche promosse o la timeline di un utente protetto. L’endpoint della cronologia delle menzioni dell’utente supporta i parametri fields e expansions e restituisce il nuovo formato di dati JSON.Configurazione dell’accountPer accedere a questi endpoint, ti serviranno:
- Un account sviluppatore approvato.
- L’autenticazione con le chiavi e i token di un’App sviluppatore che si trova all’interno di un Project.