> ## Documentation Index > Fetch the complete documentation index at: https://docs.x.com/llms.txt > Use this file to discover all available pages before exploring further. # 마이그레이션 가이드 > Direct Message endpoint의 v1.1과 v2 버전 모두 Direct Message를 생성하는 방법을 제공합니다. 관리 기능을 다루는 X API v2 standard 등급 레퍼런스입니다. export const Button = ({href, children}) => { return
; }; ## v1.1과 v2 Direct Message 관리 endpoint 비교 Direct Message endpoint의 v1.1과 v2 버전 모두 Direct Message를 생성하는 방법을 제공합니다. 이 가이드는 두 버전의 차이점을 이해하고 v2로 마이그레이션하는 데 필요한 정보를 제공하기 위한 것입니다. 두 버전의 주요 차이점은 v1.1이 1:1 대화만 지원하는 반면, v2에서는 그룹 대화 지원이 추가되었다는 점입니다. 이로 인해 v1.1은 "메시지 생성" 이벤트만 지원하지만, v2에서는 대화 참여 및 나가기 관련 이벤트도 지원합니다. 실제로 v2의 근본적인 업데이트는 dm\_conversations를 핵심 API 객체로 정립한 것입니다. v1.1에는 Direct Message를 관리하기 위한 두 개의 endpoint가 있습니다: * POST direct\_messages/events/new - 1:1 Direct Message를 생성합니다. 이 v1.1 endpoint는 1:1 메시지만 생성할 수 있으며, 그룹 메시지는 지원하지 않습니다. * DELETE direct\_messages/events/destroy - 인증 사용자의 관점에서 1:1 메시지를 삭제합니다. 이번 v2 릴리스에는 Direct Message 생성을 위한 세 개의 POST 메서드가 있습니다: * **POST /2/dm\_conversations/with/:participant\_id/messages** - 1:1 Direct Message를 생성합니다. 이 메서드는 기존 1:1 대화에 메시지를 추가하거나 새 대화를 생성합니다. :participant\_id 경로 파라미터는 메시지를 수신하는 계정의 User ID입니다. * **POST /2/dm\_conversations** - 새 그룹 대화를 생성하고 Direct Message를 추가합니다. 이 요청에는 대화 참가자 목록이 필요합니다. 동일한 참가자 목록으로 여러 대화를 생성할 수 있습니다. 이 요청은 항상 새 대화 ID를 반환합니다. * **POST /2/dm\_conversations/:dm\_conversation\_id/messages** - Direct Message를 생성하고 기존 대화에 추가합니다. :dm\_conversation\_id 경로 파라미터는 메시지가 추가될 대화의 ID입니다. 중요한 점은 대화 ID와 이벤트 ID가 X Platform의 v1.1과 v2 버전 간에 공유된다는 것입니다. 즉, 두 버전을 함께 사용할 수 있습니다. 예를 들어, Direct Message v1.1 endpoint는 단일 이벤트 반환 및 이벤트 삭제 메서드를 제공하며, 이는 아직 v2에서 사용할 수 없습니다. ID가 v1.1과 v2에서 공통이기 때문에, v2가 제공한 ID를 기반으로 v1.1 요청을 하거나, X 애플리케이션의 대화 URL에 표시된 대화 ID를 참조할 수 있습니다. 다음 표는 v1.1과 v2 Direct Message 관리 endpoint의 기본적인 측면을 비교합니다. 여기 공유된 X API v2 특성은 모든 Direct Message 조회 endpoint에 공통으로 적용됩니다. | | | | | :-------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **설명** | **Standard v1.1** | **X API v2** | | 호스트 도메인 | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com) | | Endpoint 루트 경로 | [/1.1/direct\_messages](https://api.x.com/1.1/direct_messages) | [/2/dm\_conversations](https://api.x.com/2/users/:id/dm_conversations)

Direct Message 대화가 기본 API 객체로 도입되었습니다.

이 endpoint는 MessageCreate, ParticipantsJoin, ParticipantLeave 이벤트를 조회합니다. | | 지원되는 HTTP 메서드 | POST | POST | | Group Direct Message 지원 | | ✔ | | 지원되는 이벤트 유형 | message\_create | MessageCreate, ParticipantsJoin, ParticipantsLeave | | [인증](/resources/fundamentals/authentication) | OAuth 1.0a User Context | OAuth 1.0a User Context

OAuth 2 User Context (scopes: dm.read, dm.write) | | X API v2 [Project](/resources/fundamentals/developer-apps)와 연결된 [developer App](/resources/fundamentals/authentication)의 자격 증명 필요 | | ✔ | | 기본 요청 [rate limit](/x-api/fundamentals/rate-limits)\*
\*모든 요청에 사용자 토큰 필요 | 24시간당 사용자별 1000 요청
24시간당 앱별 15000 요청 | 15분당 사용자별 200 요청

24시간당 사용자별 1000 요청

24시간당 앱별 15000 요청

이러한 rate limit은 모든 dm\_conversations POST endpoint에 걸쳐 공유됩니다. | 다음 표는 v2 POST 메서드와 v1.1을 비교합니다. 이러한 v2 제공 기능은 그룹 대화를 지원함으로써 사용 가능한 기능을 확장합니다. **새 1:1 Direct Message 생성** Path: POST /2/dm\_conversations/with/:participant\_id/messages | | | | | :-------------------------------------------------- | :------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | | **설명** | **Standard v1.1** | **X API v2** | | Endpoint 경로 | POST direct\_messages/events/new (message\_create) | POST /2/dm\_conversations/with/:participant\_id/messages | | 기본 요청 [rate limit](/x-api/fundamentals/rate-limits) | 24시간당 사용자별 1000 요청
24시간당 앱별 15000 요청 | 15분당 사용자별 200 요청

24시간당 사용자별 1000 요청

24시간당 앱별 15000 요청

이러한 rate limit은 모든 dm\_conversations POST endpoint에 걸쳐 공유됩니다. | | Group Direct Message 지원 | | ✔ | **새 Direct Message 그룹 대화 생성 및 메시지 추가** Path: POST /2/dm\_conversations | | | | | :-------------------------------------------------- | :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | | **설명** | **Standard v1.1** | **X API v2** | | Endpoint 경로 | 지원되지 않음 | POST /2/dm\_conversations | | 기본 요청 [rate limit](/x-api/fundamentals/rate-limits) | | 15분당 사용자별 200 요청

24시간당 사용자별 1000 요청

24시간당 앱별 15000 요청

이러한 rate limit은 모든 dm\_conversations POST endpoint에 걸쳐 공유됩니다. | | Group Direct Message 지원 | | ✔ | **ID로 기존 대화에 Direct Message 추가** Path: POST /2/dm\_conversations/:dm\_conversation\_id/messages | | | | | :-------------------------------------------------- | :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | | **설명** | **Standard v1.1** | **X API v2** | | Endpoint 경로 | 지원되지 않음 | POST /2/dm\_conversations/:dm\_conversation\_id/messages | | 기본 요청 [rate limit](/x-api/fundamentals/rate-limits) | | 15분당 사용자별 200 요청

24시간당 사용자별 1000 요청

24시간당 앱별 15000 요청

이러한 rate limit은 모든 dm\_conversations POST endpoint에 걸쳐 공유됩니다. | | Group Direct Message 지원 | | ✔ |