Skip to main content

​
Comparación entre los endpoints de búsqueda de eventos de Mensajes Directos en v1.1 y v2

Tanto las versiones v1.1 como v2 de los endpoints de Mensajes Directos proporcionan métodos para buscar eventos de Mensajes Directos. Esta guía está pensada para ayudar a entender las diferencias y proporcionar información para migrar a v2.  Una diferencia importante entre las dos versiones es que v1.1 solo admite conversaciones uno a uno, mientras que v2 introduce compatibilidad con conversaciones de grupo. Una consecuencia de esto es que v1.1 solo admite eventos de “message created”, mientras que v2 también admite eventos asociados con participantes que se unen y abandonan conversaciones. De hecho, una actualización fundamental de v2 es establecer dm_conversations como un objeto central de la API.    Con v1.1, hay dos endpoints para recuperar Mensajes Directos (de nuevo, los mensajes nuevos son el único tipo de evento admitido en v1.1):
  • GET direct_messages/events/show - Recupera un único evento por ID. 
  • GET direct_messages/events/list - Recupera hasta 30 días de Mensajes Directos uno a uno enviados y recibidos por el usuario autenticado. Ten en cuenta que este método no puede recuperar mensajes de conversaciones de grupo. 
Con esta versión v2, hay tres métodos GET para recuperar eventos de conversaciones de Mensajes Directos: 
  • GET /2/dm_conversations/with/:participant_id/dm_events - Recupera eventos de Mensajes Directos asociados con 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 con un ID de conversación específico, tal como se indica mediante el parámetro de ruta :dm_conversation_id. Este método admite tanto conversaciones uno a uno como conversaciones de grupo. 
  • GET /2/dm_events - Recupera eventos de Mensajes Directos asociados con un usuario, incluidas tanto conversaciones uno a uno como conversaciones de grupo. Están disponibles eventos de hasta 30 días de antigüedad.  
Un detalle importante es que los IDs de conversación y de evento se comparten entre las versiones v1.1 y v2 de la plataforma de X. Esto significa que se pueden usar ambas versiones conjuntamente. Por ejemplo, los endpoints de Mensajes Directos v1.1 proporcionan métodos para devolver un único evento y para eliminar eventos, métodos que todavía no están disponibles en v2. Dado que los IDs son comunes en v1.1 y v2, puedes realizar solicitudes v1.1 basadas en IDs proporcionados por v2, o haciendo referencia a los IDs de conversación que se muestran en las URL de conversación en la aplicación de X. La siguiente tabla compara aspectos fundamentales de los endpoints de búsqueda de eventos de Mensajes Directos entre v1.1 y v2. Las características de X API v2 que se comparten aquí son comunes a todos los endpoints de búsqueda de Mensajes Directos. Las siguientes tablas comparan los métodos GET de v2 con la versión v1.1. Ten en cuenta que estas opciones de v2 amplían las capacidades disponibles al admitir conversaciones de grupo.  **Obtener todos los mensajes en una conversación uno a uno específica **
Path: GET /2/dm_conversations/with/:participant_id/dm_events Obtener todos los mensajes por ID de conversación Path: GET /2/dm_conversations/:dm_conversation_id/dm_events Obtener todos los eventos en las conversaciones de un usuario autenticado, tanto conversaciones uno a uno como conversaciones de grupo Path: GET /2/dm_events