Pular para o conteúdo principal
Esta versão inicial da consulta de Mensagens diretas inclui três métodos GET:
  • GET /2/dm_conversations/with/:participant_id/dm_events - Recupera eventos de Mensagens diretas associados a uma conversa individual. O parâmetro de caminho :participant_id é o User ID da conta que está conversando com o usuário autenticado que faz esta solicitação.
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - Recupera eventos de Mensagens diretas associados a um ID de conversa específico, conforme indicado pelo parâmetro de caminho :dm_conversation_id.
  • GET /2/dm_events - Recupera eventos de Mensagens diretas associados a um usuário, incluindo conversas individuais e em grupo. Eventos de até 30 dias atrás estão disponíveis.
Observe que os IDs de eventos de Mensagens diretas são comuns entre a v1.1 e a v2 (bem como no X App), portanto, o método v1.1 para listar um único evento pode ser usado junto com esses novos endpoints da v2. Observe também que as Account Activity APIs Enterprise e Premium oferecem suporte a mensagens individuais da v2, mas ainda não oferecem suporte a conversas em grupo. Com esta versão, três tipos de evento são compatíveis, e esses endpoints aceitam parâmetros de query para filtrá-los:
  • MessageCreate - Uma mensagem foi criada.
  • ParticipantsJoin - Um novo participante entrou em uma conversa.
  • ParticipantsLeave - Um participante saiu de uma conversa.
Há um limite de taxa por usuário de 300 solicitações por 15 minutos para os métodos GET. Esse limite de taxa é compartilhado entre esses endpoints GET. Como você está fazendo solicitações em nome de um usuário com endpoints de Mensagens diretas v2, é necessário autenticar com OAuth 1.0a User Context ou OAuth 2.0 Authorization Code with PKCE, usando Access Tokens associados a usuários que autorizaram seu X App. Para gerar esses Access Tokens com OAuth 1.0a, você pode usar o fluxo OAuth de 3 etapas. Para gerar Access Tokens de usuário com OAuth 2.0, você pode usar o fluxo de concessão Authorization Code com PKCE. Configuração da conta Para acessar esses endpoints, você precisará de: Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de Introdução.
⌘I