Guía de migración

Comparación de los endpoints v1.1 y v2 para gestionar Mensajes Directos

Tanto las versiones v1.1 como v2 de los endpoints de Mensajes Directos proporcionan métodos para crear mensajes 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 gestionar Mensajes Directos:

POST direct_messages/events/new - Crea un Mensaje Directo uno a uno. Este endpoint 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 desde 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 añade el mensaje a una conversación uno a uno existente o crea una nueva. El parámetro de ruta :participant_id es el User ID de la cuenta que recibe el mensaje.
POST /2/dm_conversations - Crea una nueva conversación grupal y añade 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 añade a una conversación existente. El parámetro de ruta :dm_conversation_id es el ID de la conversación a la que se añadirá el mensaje.

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 para gestionar Mensajes Directos. Las características de la X API v2 aquí compartidas son comunes a todos los endpoints de búsqueda de Mensajes Directos.


Descripción	Standard v1.1	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	OAuth 1.0a User Context	OAuth 1.0a User Context OAuth 2 User Context (scopes: dm.read, dm.write)
Requiere el uso de credenciales de una App de desarrollador asociada a un Project de la X API v2		✔
Rate limits de solicitud por defecto* *Todas las solicitudes requieren tokens de usuario	1000 solicitudes por usuario cada 24 horas 15000 solicitudes por app cada 24 horas	200 solicitudes cada 15 minutos por usuario 1000 solicitudes por usuario cada 24 horas 15000 solicitudes por app cada 24 horas Estos rate limits 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 ofertas 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	Standard v1.1	X API v2
Ruta del endpoint	POST direct_messages/events/new (message_create)	POST /2/dm_conversations/with/:participant_id/messages
Rate limits de solicitud por defecto	1000 solicitudes por usuario cada 24 horas 15000 solicitudes por app cada 24 horas	200 solicitudes cada 15 minutos por usuario 1000 solicitudes por usuario cada 24 horas 15000 solicitudes por app cada 24 horas Estos rate limits se comparten entre todos los endpoints POST de dm_conversations.
Admite Mensajes Directos grupales		✔

Crear una nueva conversación grupal de Mensajes Directos y añadir un mensaje a ella Ruta: POST /2/dm_conversations


Descripción	Standard v1.1	X API v2
Ruta del endpoint	No admitido	POST /2/dm_conversations
Rate limits de solicitud por defecto		200 solicitudes cada 15 minutos por usuario 1000 solicitudes por usuario cada 24 horas 15000 solicitudes por app cada 24 horas Estos rate limits se comparten entre todos los endpoints POST de dm_conversations.
Admite Mensajes Directos grupales		✔

Añadir un Mensaje Directo a una conversación existente por ID Ruta: POST /2/dm_conversations/:dm_conversation_id/messages


Descripción	Standard v1.1	X API v2
Ruta del endpoint	No admitido	POST /2/dm_conversations/:dm_conversation_id/messages
Rate limits de solicitud por defecto		200 solicitudes cada 15 minutos por usuario 1000 solicitudes por usuario cada 24 horas 15000 solicitudes por app cada 24 horas Estos rate limits se comparten entre todos los endpoints POST de dm_conversations.
Admite Mensajes Directos grupales		✔

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Guía de migración

Comparación de los endpoints v1.1 y v2 para gestionar Mensajes Directos

​Comparación de los endpoints v1.1 y v2 para gestionar Mensajes Directos

Comparación de los endpoints v1.1 y v2 para gestionar Mensajes Directos