Saltar al contenido principal
Esta versión inicial de la consulta de Mensajes Directos incluye tres métodos GET:
  • GET /2/dm_conversations/with/:participant_id/dm_events - Recupera eventos de Mensajes Directos asociados a una conversación uno a uno. El parámetro de ruta :participant_id es el User ID de la cuenta que mantiene la conversación con el usuario autenticado que realiza esta solicitud.
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - Recupera eventos de Mensajes Directos asociados a un id de conversación específico, según lo indicado por el parámetro de ruta :dm_conversation_id.
  • GET /2/dm_events - Recupera eventos de Mensajes Directos asociados a un usuario, incluidas conversaciones tanto uno a uno como de grupo. Hay eventos disponibles de hasta hace 30 días.
Tenga en cuenta que los ids de eventos de Mensajes Directos son comunes entre v1.1 y v2 (así como en la X App), por lo que el método de v1.1 para listar un único evento se puede usar junto con estos nuevos endpoints de v2. Tenga también en cuenta que las Account Activity APIs de Enterprise y Premium admiten mensajes uno a uno de v2, pero aún no admiten conversaciones de grupo. Con esta versión se admiten tres tipos de eventos, y estos endpoints aceptan parámetros query para filtrarlos:
  • MessageCreate - Se ha creado un mensaje.
  • ParticipantsJoin - Un nuevo participante se ha unido a una conversación.
  • ParticipantsLeave - Un participante ha salido de una conversación.
Existe un límite de tasa por usuario de 300 solicitudes por 15 minutos para los métodos GET. Este límite de tasa se comparte entre estos endpoints GET. Dado que está realizando solicitudes en nombre de un usuario con endpoints de Mensajes Directos v2, debe autenticarse con OAuth 1.0a User Context o OAuth 2.0 Authorization Code with PKCE, usando Access Tokens asociados con usuarios que hayan autorizado su X App. Para generar estos Access Tokens con OAuth 1.0a, puede usar el flujo de OAuth de 3 fases. Para generar Access Tokens de usuario con OAuth 2.0, puede usar el Authorization Code with PKCE grant flow. Configuración de la cuenta Para acceder a estos endpoints, necesitará: Obtenga más información sobre cómo acceder a los endpoints de la X API v2 en nuestra guía de introducción.
⌘I