Guía de migración

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.

Descripción	v1.1 estándar	X API v2
Dominio del host	https://api.x.com	https://api.x.com
Ruta raíz del endpoint	/1.1/direct_messages	/2/dm_conversations Las conversaciones de mensajes directos se introducen como un objeto fundamental de la API.  Estos endpoints recuperan eventos MessageCreate, ParticipantsJoin y ParticipantLeave.
Métodos HTTP admitidos	POST	POST
Admite mensajes directos grupales		✔
Tipos de eventos admitidos	message_create	MessageCreate, ParticipantsJoin, ParticipantsLeave
Autenticación	Contexto de usuario de OAuth 1.0a	Contexto de usuario de OAuth 1.0a Contexto de usuario de OAuth 2 (scopes: dm.read, dm.write)
Requiere el uso de credenciales de una App de desarrollador asociada con un Project de X API v2		✔
Límites de tasa de solicitud predeterminados* *Todas las solicitudes requieren tokens de usuario	1000 solicitudes por usuario por 24 horas 15000 solicitudes por app por 24 horas	200 solicitudes por 15 minutos por usuario 1000 solicitudes por usuario por 24 horas 15000 solicitudes por app por 24 horas Estos límites de tasa se comparten entre todos los endpoints POST de dm_conversations.

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

Descripción	Estándar v1.1	X API v2
Ruta del endpoint	POST direct_messages/events/new (message_create)	POST /2/dm_conversations/with/:participant_id/messages
Límites de tasa de solicitudes predeterminados de rate limits	1000 solicitudes por usuario cada 24 horas 15000 solicitudes por aplicación cada 24 horas	200 solicitudes por usuario cada 15 minutos 1000 solicitudes por usuario cada 24 horas 15000 solicitudes por aplicación cada 24 horas Estos límites de tasa se comparten entre todos los endpoints POST de dm_conversations.
Admite Mensajes Directos en grupo		✔

Crear una nueva conversación grupal de Mensajes Directos y agregar un mensaje

Ruta: POST /2/dm_conversations

Descripción	Estándar v1.1	X API v2
Ruta del endpoint	No admitido	POST /2/dm_conversations
Límites de tasa de solicitudes predeterminados de rate limits		200 solicitudes por usuario cada 15 minutos 1000 solicitudes por usuario cada 24 horas 15000 solicitudes por aplicación cada 24 horas Estos límites de tasa se comparten entre todos los endpoints POST de dm_conversations.
Admite Mensajes Directos en grupo		✔

Agregar un Mensaje Directo a una conversación existente mediante su ID

Ruta: POST /2/dm_conversations/:dm_conversation_id/messages

Descripción	Estándar v1.1	X API v2
Ruta del endpoint	No admitido	POST /2/dm_conversations/:dm_conversation_id/messages
Límites de tasa de solicitudes predeterminados de rate limits		200 solicitudes por usuario cada 15 minutos 1000 solicitudes por usuario cada 24 horas 15000 solicitudes por aplicación cada 24 horas Estos límites de tasa se comparten entre todos los endpoints POST de dm_conversations.
Admite Mensajes Directos en grupo		✔