Guía de migración

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.

Descripción	v1.1 estándar	X API v2
Host domain	https://api.x.com	https://api.x.com
Endpoint root path	/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.
HTTP methods supported	GET	GET
Supports Group Direct Messages		✔
Event types supported	message_create	MessageCreate, ParticipantsJoin, ParticipantsLeave
Authentication	OAuth 1.0a User Context	OAuth 1.0a User Context OAuth 2 User Context (scopes: dm.read, tweet.read, user.read)
Requires the use of credentials from a developer App associated with a X API v2 Project		✔
Default request rate limits* *All requests require user tokens		Solicitudes GET: 300 solicitudes por 15 min El límite de tasa se aplica a los tres endpoints

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

Descripción	Standard v1.1	X API v2
Ruta del endpoint	GET  /1.1/direct_messages/events/list	GET /2/dm_conversations/with/:participant_id/dm_events
Cuánto historial de eventos está disponible	30 días	Sin límite
Límites de tasa de solicitudes predeterminados rate limits	15 solicitudes cada 15 minutos	300 solicitudes cada 15 minutos El límite de tasa se aplica a los tres endpoints GET

Obtener todos los mensajes por ID de conversación

Path: GET /2/dm_conversations/:dm_conversation_id/dm_events

Descripción	Standard v1.1	X API v2
Ruta del endpoint	No compatible. V1.1 solo puede devolver mensajes de conversaciones uno a uno y no admite la recuperación de eventos por ID de conversación.	GET /2/dm_conversations/:dm_conversation_id/dm_events
Cuánto historial de eventos está disponible	30 días	Sin límite
Admite conversaciones de grupo		✔
Límites de tasa de solicitudes predeterminados rate limits	15 solicitudes cada 15 minutos	300 solicitudes cada 15 minutos El límite de tasa se aplica a los tres endpoints GET

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

Descripción	Standard v1.1	X API v2
Ruta del endpoint	GET /1.1/direct_messages/events/list V1.1 solo puede devolver mensajes de conversaciones uno a uno.	GET /2/dm_events
Cuánto historial de eventos está disponible	30 días	30 días
Admite conversaciones de grupo		✔
Límites de tasa de solicitudes predeterminados rate limits	15 solicitudes cada 15 minutos	300 solicitudes cada 15 minutos El límite de tasa se aplica a los tres endpoints GET