Skip to main content
이 가이드는 Direct Message 조회 endpoint를 애플리케이션에 통합하기 위해 알아야 할 핵심 개념을 다룹니다.

인증

DM endpoint는 비공개 대화에 접근하기 위해 사용자 인증이 필요합니다:
App-Only 인증은 지원되지 않습니다. 모든 Direct Message는 비공개입니다.

필수 scope (OAuth 2.0)


대화 유형

1:1

항상 정확히 두 명의 참가자가 있습니다. 대화 ID 형식: {smaller_user_id}-{larger_user_id}

그룹

두 명 이상의 참가자가 있습니다. 시간이 지나면서 구성원이 바뀔 수 있습니다.

이벤트 유형

예시 이벤트


Field 및 expansion

기본 field

사용 가능한 field

사용 가능한 expansion

Expansion 사용 예시

cURL

페이지네이션

DM 이벤트는 최신순(역시간순)으로 반환됩니다:
cURL
최대 30일 전까지의 이벤트를 사용할 수 있습니다.

v1.1과의 ID 호환성

대화 ID와 이벤트 ID는 v1.1과 v2 endpoint 간에 공유됩니다. 따라서 다음과 같은 작업이 가능합니다:
  • v2로 이벤트를 조회한 다음 v1.1로 특정 메시지를 삭제
  • API 요청에서 x.com URL에 포함된 대화 ID 참조

다음 단계

빠른 시작

첫 DM 조회 요청 만들기

DM 전송

Direct Message 전송하기

API 레퍼런스

전체 endpoint 문서

샘플 코드

동작하는 코드 예제