Skip to main content
Account Activity API(AAA)는 지원 중단 예정입니다. 앞으로는 실시간 사용자 활동 전달을 위해 X Activity API(XAA)를 확인하세요.
이 가이드는 레거시 Enterprise Account Activity API에서 V2 Account Activity API로 마이그레이션하는 데 도움을 줍니다. 핵심 기능은 그대로 유지되지만, 엔드포인트 구조와 인증 방식이 X API v2와 일관되도록 업데이트되었습니다.

​
변경 사항 요약

  • API 형식: 엔드포인트는 /1.1/account_activity/ 대신 /2/account_activity/ 기본 경로를 사용합니다.
  • 웹훅 관리: 웹훅 생성, 목록 조회, 검증(CRC), 삭제는 V2 Webhooks API에서 처리됩니다.
  • 인증: V2 엔드포인트는 다음 중 하나가 필요합니다:
    • 사용자별 작업(예: 사용자 구독)에는 OAuthUser(3-legged OAuth).
    • 앱 수준 작업(예: 구독 목록 조회/삭제)에는 OAuth2 App Only(Bearer Token).
    • V1.1은 다양한 요구 사항을 사용했으며, 주로 OAuth 1.0a를 사용했습니다.
  • 엔드포인트 매핑:
  • 응답 형식: AAAPI 문서에서 성공 및 오류 응답 구조를 확인하세요.
마이그레이션할 때는 새로운 기본 경로를 사용하도록 코드를 업데이트하고, 인증 흐름을 조정하며, V2 Webhooks API를 사용해 웹훅을 관리하세요.

​
마이그레이션 방법

  • 패키지 선택:
    • 다음 사항을 고려하여 Account Activity API 접근을 위한 Enterprise 또는 Self-serve 패키지를 선택하세요:
      • 필요한 웹훅 수.
      • 현재/예상 구독 또는 인증된 사용자 수.
      • X 클라이언트 애플리케이션 수.
      • 원하는 지원 수준(포럼 vs. 관리형 엔터프라이즈 1:1 지원).
      • 가격 세부 정보(Enterprise는 영업팀에 문의).
  • OAuth 2.0으로 인증 업데이트:
    • X 앱에 “Read, Write, and Access Direct Messages” 권한이 있는지 확인하세요.
    • V2 엔드포인트에 대해 OAuth 2.0으로 업데이트하세요. 스코프가 변경된 경우 사용자를 재인증하세요.
    • 다음을 관리하려면 Developer Console을 사용하세요:
      • OAuth 2.0 액세스 토큰.
      • 클라이언트 ID 및 클라이언트 시크릿.
  • 웹훅 확인 또는 재구성:
  • 샘플 앱: