Skip to main content

​
Comparación de los endpoints Administrar mensajes directos de v1.1 y v2

Las versiones v1.1 y v2 de los endpoints de mensajes directos proporcionan métodos para crear mensajes directos. Esta guía está pensada para ayudar a comprender 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 grupales. Una consecuencia de esto es que v1.1 solo admite eventos de “mensaje creado”, mientras que v2 también admite eventos asociados con la incorporación y la salida de participantes de las 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 administrar mensajes directos:
  • POST direct_messages/events/new - Crea un mensaje directo uno a uno. Este endpoint de v1.1 solo puede crear mensajes uno a uno y no admite mensajes grupales.  
  • DELETE direct_messages/events/destroy - Elimina un mensaje uno a uno de la vista del usuario autenticado. 
Con esta versión v2, hay tres métodos POST para crear mensajes directos: 
  • POST /2/dm_conversations/with/:participant_id/messages - Crea un mensaje directo uno a uno. Este método agrega el mensaje a una conversación uno a uno existente o crea una nueva. El parámetro de ruta :participant_id es el id de usuario de la cuenta que recibe el mensaje. 
  • POST /2/dm_conversations - Crea una nueva conversación grupal y agrega un mensaje directo a ella. Estas solicitudes requieren una lista de participantes de la conversación. Ten en cuenta que puedes crear varias conversaciones con la misma lista de participantes. Estas solicitudes siempre devolverán un nuevo id de conversación. 
  • POST /2/dm_conversations/:dm_conversation_id/messages - Crea un mensaje directo y lo agrega a una conversación existente. El parámetro de ruta :dm_conversation_id es el id de la conversación a la que se agregará el mensaje. 
Un detalle importante es que los ID 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 a la vez. Por ejemplo, los endpoints de mensajes directos de v1.1 proporcionan métodos para devolver un único evento y para eliminar eventos, métodos que aún no están disponibles con v2. Dado que los ID son comunes entre v1.1 y v2, puedes realizar solicitudes de v1.1 basadas en ID proporcionados por v2, o haciendo referencia a los ID 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 administración de mensajes directos de v1.1 y v2. Las características de X API v2 que se comparten aquí son comunes a todos los endpoints de consulta de mensajes directos. Las siguientes tablas comparan los métodos POST de v2 con la versión v1.1. Ten en cuenta que estas funcionalidades de v2 amplían las capacidades disponibles al admitir conversaciones grupales.  Crear un nuevo mensaje directo uno a uno Ruta: POST /2/dm_conversations/with/:participant_id/messages Crear una nueva conversación grupal de Mensajes Directos y agregar un mensaje Ruta: POST /2/dm_conversations Agregar un Mensaje Directo a una conversación existente mediante su ID Ruta: POST /2/dm_conversations/:dm_conversation_id/messages