Skip to main content

​
v1.1 및 v2 다이렉트 메시지 이벤트 조회 엔드포인트 비교

v1.1과 v2 버전의 다이렉트 메시지 엔드포인트는 모두 다이렉트 메시지 이벤트를 조회하는 메서드를 제공합니다. 이 가이드는 두 버전 간의 차이를 이해하고 v2로 마이그레이션하는 데 필요한 정보를 제공하기 위한 것입니다.  두 버전 간의 주요 차이점은 v1.1은 1:1 대화만 지원하는 반면, v2에서는 그룹 대화 지원이 도입되었다는 점입니다. 이와 관련해 나타나는 차이점 중 하나는 v1.1은 “message created” 이벤트만 지원하는 반면, v2는 참가자가 대화에 참여하거나 떠나는 것과 관련된 이벤트도 지원한다는 것입니다. 특히 v2의 근본적인 업데이트 중 하나는 dm_conversations를 핵심 API 객체로 확립한 것입니다.    v1.1에서는 다이렉트 메시지를 가져오기 위한 엔드포인트가 두 개 있습니다(다시 말해, v1.1에서 지원되는 이벤트 타입은 새 메시지뿐입니다).
  • GET direct_messages/events/show - ID로 단일 이벤트를 가져옵니다. 
  • GET direct_messages/events/list - 인증된 사용자가 주고받은 1:1 다이렉트 메시지를 최대 30일 치까지 가져옵니다. 이 메서드는 그룹 대화의 메시지를 가져올 수 없다는 점에 유의하세요. 
v2에서는 다이렉트 메시지 대화 이벤트를 가져오기 위한 GET 메서드가 세 가지 있습니다. 
  • GET /2/dm_conversations/with/:participant_id/dm_events - 1:1 대화와 관련된 다이렉트 메시지 이벤트를 가져옵니다. :participant_id 경로 파라미터는 이 요청을 보내는 인증된 사용자와 대화를 나누고 있는 계정의 사용자 ID입니다. 
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - :dm_conversation_id 경로 파라미터로 지정된 특정 대화 ID와 관련된 다이렉트 메시지 이벤트를 가져옵니다. 이 메서드는 1:1 및 그룹 대화를 모두 지원합니다. 
  • GET /2/dm_events - 사용자와 관련된 다이렉트 메시지 이벤트를 가져오며, 여기에는 1:1 및 그룹 대화가 모두 포함됩니다. 최대 30일 전까지의 이벤트를 조회할 수 있습니다.  
중요한 점은 대화 및 이벤트 ID가 X 플랫폼의 v1.1과 v2 버전 간에 공유된다는 것입니다. 이는 두 버전을 함께 사용할 수 있음을 의미합니다. 예를 들어, 다이렉트 메시지 v1.1 엔드포인트는 단일 이벤트를 반환하고 이벤트를 삭제하는 메서드를 제공하는데, 이는 아직 v2에서는 제공되지 않습니다. ID가 v1.1과 v2 간에 공통이므로, v2가 제공하는 ID를 기반으로 v1.1 요청을 하거나 X 애플리케이션의 대화 URL에 표시되는 대화 ID를 참조해 v1.1 요청을 보낼 수 있습니다. 다음 표는 v1.1 및 v2 다이렉트 메시지 이벤트 조회 엔드포인트의 기본적인 측면을 비교합니다. 여기에서 설명하는 X API v2 특성은 모든 다이렉트 메시지 조회 엔드포인트에 공통적으로 적용됩니다.
DescriptionStandard v1.1X API v2
Host domainhttps://api.x.comhttps://api.x.com
Endpoint root path/1.1/direct_messages/2/dm_conversations

다이렉트 메시지 대화가 기본적인 API 객체로 도입되었습니다. 

이 엔드포인트들은 MessageCreate, ParticipantsJoin, ParticipantLeave 이벤트를 가져옵니다.
HTTP methods supportedGETGET
Supports Group Direct Messages✔
Event types supportedmessage_createMessageCreate, ParticipantsJoin, ParticipantsLeave
AuthenticationOAuth 1.0a User ContextOAuth 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		GET 요청: 15분당 300회

요청 한도는 세 엔드포인트 전체에 걸쳐 적용됩니다
다음 표들은 v2 GET 메서드를 v1.1 버전과 비교합니다. 이 v2 제공 기능이 그룹 대화를 지원함으로써 사용 가능한 기능을 확장한다는 점에 유의하세요.  **특정 1:1 대화의 모든 메시지 가져오기 **
Path: GET /2/dm_conversations/with/:participant_id/dm_events
설명Standard v1.1X API v2
엔드포인트 경로GET 

/1.1/direct_messages/events/list		GET /2/dm_conversations/with/:participant_id/dm_events
사용 가능한 이벤트 이력 보존 기간30일제한 없음
기본 요청 요청 한도15회/15분300회/15분
요청 한도는 세 가지 GET 엔드포인트 전체에 공통으로 적용됩니다
대화 ID로 모든 메시지 가져오기 경로: GET /2/dm_conversations/:dm_conversation_id/dm_events
설명Standard v1.1X API v2
엔드포인트 경로지원되지 않습니다. V1.1은 일대일 대화의 메시지만 반환할 수 있으며, 대화 ID별로 이벤트를 조회하는 기능은 지원하지 않습니다.GET /2/dm_conversations/:dm_conversation_id/dm_events
사용 가능한 이벤트 이력 보존 기간30일제한 없음
그룹 대화 지원 여부✔
기본 요청 요청 한도15회/15분300회/15분
요청 한도는 세 가지 GET 엔드포인트 전체에 공통으로 적용됩니다
인증된 사용자의 모든 대화(일대일 및 그룹 대화 모두)에 대한 모든 이벤트 가져오기 경로: GET /2/dm_events
설명Standard v1.1X API v2
엔드포인트 경로GET /1.1/direct_messages/events/list

V1.1은 일대일 대화의 메시지만 반환할 수 있습니다.		GET /2/dm_events
사용 가능한 이벤트 이력 보존 기간30일30일
그룹 대화 지원 여부✔
기본 요청 요청 한도15회/15분300회/15분
요청 한도는 세 가지 GET 엔드포인트 전체에 공통으로 적용됩니다