API dei webhook del filtered stream

​

Panoramica

Il gruppo di endpoint filtered stream consente agli sviluppatori di filtrare uno stream di Post pubblici. Le funzionalità di questo gruppo includono più endpoint che permettono di creare e gestire regole e di applicarle per filtrare uno stream di Post che restituisce i Post pubblici corrispondenti. Questo gruppo di endpoint consente di ascoltare argomenti ed eventi specifici, monitorare le conversazioni su competizioni, comprendere come si sviluppano i trend e molto altro.

Gli sviluppatori possono utilizzare l’endpoint REST delle regole per aggiungere e rimuovere regole e filtrare i Post che corrispondono a criteri definiti. Queste regole possono essere create con operatori che eseguono il matching sugli attributi del Post, come parole chiave, hashtag e URL. Operatori e clausole di regola possono essere combinati con logica booleana e parentesi per affinare il comportamento di corrispondenza del filtro.

Una volta aggiunto un set di regole, puoi registrare il tuo webhook, al quale X inizierà a recapitare Oggetti Post in formato JSON. Riceverai nel tuo webhook solo contenuti corrispondenti alle tue regole.

Questo endpoint supporta i Post modificati. Il tuo webhook riceverà Post modificati che corrispondono a uno o più dei tuoi filtri, insieme alla loro cronologia delle modifiche, inclusa una matrice di ID del Post. Per i Post senza cronologia delle modifiche, questa matrice conterrà un singolo ID. Per i Post che sono stati modificati, questa matrice contiene più ID, disposti in ordine crescente a riflettere l’ordine delle modifiche, con la versione più recente all’ultima posizione della matrice. Per ulteriori informazioni su come funzionano le modifiche ai Post, consulta la pagina Nozioni fondamentali sulle modifiche ai Post.

Nota: questo gruppo di endpoint è simile al v2 filtered stream endpoint per la configurazione delle regole. L’unica differenza riguarda i meccanismi di consegna dei Post che corrispondono alle regole.

• Con il v2 filtered stream endpoint devi stabilire una connessione persistente e ascoltare i Post che corrispondono alle tue regole.
• Con questo filtered stream webhook endpoint registri il tuo webhook e X consegna al tuo webhook i Post che corrispondono alle tue regole.

Questo elimina la necessità di gestire le disconnessioni dovute a interruzioni lato client o a riavvii lato server del nostro servizio. Poiché probabilmente consegneremo centinaia di eventi al secondo, è necessario che il tuo server webhook sia in grado di gestire questi tentativi di connessione simultanei.

Questo endpoint è attualmente disponibile per gli sviluppatori Enterprise e supporta la seguente configurazione:

• Oltre 25.000 regole per Project
• Possibilità di utilizzare tutti gli operatori durante la creazione delle regole
• Possibilità di creare regole fino a 2048 caratteri
• Richiedi l’accesso qui per Enterprise

I Post restituiti dal filtered stream vengono conteggiati ai fini del Post cap mensile.

Configurazione dell’account

Per accedere a questi endpoint, avrai bisogno di:

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

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

Avvio rapido