Skip to main content

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

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 ayudarte 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 soporte para conversaciones grupales. Un resultado de esto es que v1.1 solo admite eventos de “mensaje creado”, mientras que v2 también admite eventos asociados con participantes que se unen o abandonan conversaciones. De hecho, una actualización fundamental de v2 es establecer dm_conversations como un objeto principal de la API. Con v1.1 hay dos endpoints para recuperar Mensajes Directos (nuevamente, 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 grupales.
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 tiene 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, indicado por el parámetro de ruta :dm_conversation_id. Este método admite conversaciones tanto uno a uno como grupales.
  • GET /2/dm_events - Recupera eventos de Mensajes Directos asociados con un usuario, incluyendo conversaciones uno a uno y grupales. Están disponibles los eventos de hasta hace 30 días.
Un detalle importante es que los IDs de conversación y evento se comparten entre las versiones v1.1 y v2 de la X Platform. Esto significa que ambas versiones se pueden usar juntas. Por ejemplo, los endpoints v1.1 de Mensajes Directos proporcionan métodos para devolver un único evento y para eliminar eventos, métodos que aún no están disponibles con v2. Como los IDs son comunes entre v1.1 y v2, puedes realizar solicitudes v1.1 basadas en IDs proporcionados por v2, o haciendo referencia a los IDs de conversación mostrados en las URLs de conversación en la aplicación X. La siguiente tabla compara aspectos fundamentales de los endpoints v1.1 y v2 de búsqueda de eventos de Mensajes Directos. Las características de la X API v2 aquí compartidas 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 ofertas de v2 amplían las capacidades disponibles al admitir conversaciones grupales. **Obtener todos los mensajes de una conversación uno a uno específica **
Ruta: GET /2/dm_conversations/with/:participant_id/dm_events **Obtener todos los mensajes por ID de conversación ** Ruta: GET /2/dm_conversations/:dm_conversation_id/dm_events Obtener todos los eventos de las conversaciones de un usuario autenticado, tanto uno a uno como grupales Ruta: GET /2/dm_events