소개

X Activity API(XAA) 엔드포인트 그룹은 개발자가 X 플랫폼에서 발생하는 활동 이벤트에 접근하도록 지원합니다.

개발자는 ProfileBioUpdate, ProfilePictureUpdate 등 관심 있는 이벤트를 구독하고, 원하는 사용자 id로 필터링할 수 있습니다. 해당 사용자 id에 해당하는 이벤트는 초미만 지연으로 앱에 전달됩니다.

X Activity API는 공개 베타로 제공됩니다. 공개 베타 기간에는 버그, 호환성 파괴 변경, 미완성 기능이 있을 수 있습니다.

여러분의 피드백은 매우 소중합니다. developer community forums를 통해 문제를 신고해 주세요.

​

전달 메커니즘

X Activity API는 현재 다음 전달 메커니즘을 통해 이벤트를 앱으로 전송하는 방식을 지원합니다:

• 지속 연결 HTTP 스트림
• Webhook

​

지원되는 이벤트 유형

현재 X Activity API는 다음 프로필 업데이트 이벤트를 지원합니다:

Category	Event Name	Description
Profile	ProfileBioUpdate	사용자가 프로필 소개를 업데이트할 때 발생
Profile	ProfilePictureUpdate	사용자가 프로필 사진을 업데이트할 때 발생
Profile	ProfileBannerUpdate	사용자가 프로필 배너를 업데이트할 때 발생
Profile	ProfileGeoUpdate	사용자가 프로필 위치를 업데이트할 때 발생
Profile	ProfileUrlUpdate	사용자가 프로필 웹사이트 URL을 업데이트할 때 발생
Profile	ProfileScreennameUpdate	사용자가 표시 이름을 업데이트할 때 발생
Profile	ProfileVerifiedBadgeUpdate	사용자가 인증 배지를 업데이트할 때 발생

향후 릴리스에서 XAA는 소셜 상호작용, 콘텐츠 참여, 수익화 기능 등 추가 이벤트 유형까지 지원 범위를 확대할 예정입니다. 새 이벤트 유형이 제공될 때마다 문서를 계속 업데이트하겠습니다.

참고: XAA는 게시물을 전달하지 않습니다. 실시간 게시물 전달이 필요하면, 개발자가 실시간으로 게시물을 필터링하고 스트리밍할 수 있는 Filtered Stream 엔드포인트를 참조하세요.

​

이벤트 개인정보 보호 및 인증

X Activity API는 아래 설명처럼 X 앱과 동일한 기준으로 공개 이벤트와 비공개 이벤트를 구분합니다.

​

공개 이벤트

공개 이벤트는 공개 사용자 계정이 모든 X 사용자에게 보이는 방식으로 수행하는 활동입니다. 이러한 이벤트는 X 플랫폼의 모든 사용자가 열람할 수 있으며, 열람을 위해 사용자의 OAuth 인증이 필요하지 않습니다.

현재 공개 이벤트:

• 프로필 업데이트(소개, 사진, 배너, 위치, URL, 사용자 이름 변경)

이러한 공개 이벤트는 필터에서 사용자 ID를 지정해 구독을 생성하면 XAA를 통해 수신할 수 있습니다.

​

비공개 이벤트

비공개 이벤트는 OAuth 인증을 통해 사용자의 명시적 동의가 필요한 활동입니다. 사용자는 X를 통해 인증하고, 이러한 이벤트에 접근할 수 있도록 Developer 앱에 명시적으로 권한을 부여해야 합니다.

비공개 이벤트의 인증 요건:

• 사용자는 OAuth 2.0을 통해 애플리케이션을 인증해야 합니다
• 애플리케이션은 적절한 OAuth 스코프를 획득해야 합니다
• 사용자는 앱이 이러한 이벤트에 접근하도록 명시적으로 권한을 부여해야 합니다
• 비공개 이벤트 구독은 애플리케이션을 승인한 사용자에 대해서만 생성할 수 있습니다

​

구독 한도

X Activity API는 계정 티어에 따라 구독 한도가 다릅니다:

패키지 티어	최대 구독 수
Free	제공되지 않음
Basic	50
Pro	2500
Enterprise	20,000
Partner	100,000

계정 설정

다음 엔드포인트에 액세스하려면 다음이 필요합니다:

• 승인된 개발자 계정
• Project 내에 있는 Developer 앱에서 발급된 키와 토큰을 사용한 인증

X API v2 엔드포인트에 대한 액세스 방법은 시작 가이드에서 자세히 알아보세요.