Vai al contenuto principale
Questa versione iniziale del lookup dei Messaggi Diretti include tre metodi GET:
  • GET /2/dm_conversations/with/:participant_id/dm_events - Recupera gli eventi dei Messaggi Diretti associati a una conversazione uno-a-uno. Il parametro di percorso :participant_id è l’ID utente dell’account che sta conversando con l’utente autenticato che effettua questa richiesta.
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - Recupera gli eventi dei Messaggi Diretti associati a uno specifico ID conversazione, come indicato dal parametro di percorso :dm_conversation_id.
  • GET /2/dm_events - Recupera gli eventi dei Messaggi Diretti associati a un utente, incluse sia le conversazioni uno-a-uno sia quelle di gruppo. Sono disponibili eventi fino a 30 giorni nel passato.
Nota che gli ID degli eventi dei Messaggi Diretti sono comuni tra v1.1 e v2 (così come nell’X App), quindi il metodo v1.1 per elencare un singolo evento può essere usato insieme a questi nuovi endpoint v2. Nota anche che le Account Activity API Enterprise e Premium supportano i messaggi uno-a-uno v2, ma non supportano ancora le conversazioni di gruppo. Con questa versione, sono supportati tre tipi di evento e questi endpoint accettano parametri di query per filtrarli:
  • MessageCreate - È stato creato un messaggio.
  • ParticipantsJoin - Un nuovo partecipante si è unito a una conversazione.
  • ParticipantsLeave - Un partecipante ha lasciato una conversazione.
È previsto un limite di velocità per utente di 300 richieste ogni 15 minuti per i metodi GET. Questo limite di velocità è condiviso tra questi endpoint GET. Poiché stai effettuando richieste per conto di un utente con gli endpoint dei Messaggi Diretti v2, devi autenticarti con OAuth 1.0a User Context oppure con OAuth 2.0 Authorization Code with PKCE, utilizzando Access Tokens associati a utenti che hanno autorizzato la tua X App. Per generare questi Access Tokens con OAuth 1.0a, puoi usare il flusso OAuth a 3 vie. Per generare Access Tokens utente con OAuth 2.0, puoi usare il Authorization Code with PKCE grant flow. Configurazione dell’account Per accedere a questi endpoint, ti serviranno: Scopri di più su come ottenere l’accesso agli endpoint della X API v2 nella nostra guida introduttiva.
⌘I