메인 콘텐츠로 건너뛰기

​
v2 Account Activity API 마이그레이션 가이드

이 가이드는 레거시 Enterprise Account Activity API에서 v2 Account Activity API로 마이그레이션하는 방법을 안내합니다. 핵심 기능은 동일하지만, 엔드포인트 구조와 인증 방식은 X API v2와의 일관성을 위해 업데이트되었습니다.

​
변경 사항 요약

  • API 형식: 엔드포인트가 /1.1/account_activity/ 대신 /2/account_activity/ 기본 경로를 사용합니다.
  • Webhook 관리: Webhook 생성, 조회, 검증(CRC), 삭제는 V2 Webhooks API로 처리합니다.
  • 인증: V2 엔드포인트는 다음 중 하나가 필요합니다:
    • OAuthUser(3-legged OAuth): 사용자 단위 작업(예: 사용자 구독)에 사용.
    • OAuth2 App Only(베어러 토큰): 앱 수준 작업(예: 구독 조회/삭제)에 사용.
    • V1.1은 요구 사항이 다양했으며, 종종 OAuth 1.0a를 사용했습니다.
  • 엔드포인트 매핑:
V1.1 엔드포인트V2 해당 항목/동작비고
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooksDocs. OAuth2AppOnly 필요.
GET /1.1/account_activity/webhooks.jsonGET /2/webhooksDocs. OAuth2AppOnly 필요.
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_idCRC 트리거. Docs. OAuth2AppOnly 필요.
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_idDocs. OAuth2AppOnly 필요.
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonPOST /2/account_activity/webhooks/:webhook_id/subscriptions/allOAuthUser 필요.
GET /1.1/account_activity/subscriptions/count.jsonGET /2/account_activity/subscriptions/countOAuth2AppOnly 필요.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/allOAuthUser 필요.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all/listOAuth2AppOnly 필요.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allOAuth2AppOnly 필요.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/all사용 중단/직접 해당 없음개별 삭제를 사용하거나 DELETE /2/webhooks/:webhook_id로 webhook을 제거하세요.
  • 응답 형식: AAAPI 문서에서 성공 및 오류 응답 구조를 검토하세요.
마이그레이션 시 새 기본 경로를 사용하도록 코드를 업데이트하고, 인증 플로우를 조정하며, V2 Webhooks API를 사용해 webhook을 관리하세요.

​
마이그레이션 방법

  • 패키지 선택:
    • Account Activity API 액세스를 위해 Enterprise 또는 Pro 패키지를 선택하세요. 다음을 고려하세요:
      • 필요한 웹훅 수
      • 현재/예상 구독 수 또는 권한이 부여된 사용자 수
      • X 클라이언트 애플리케이션 수
      • 원하는 지원 수준(포럼 vs. 관리형 엔터프라이즈 1:1 지원)
      • 가격 세부 정보(Enterprise는 영업팀에 문의)
  • 인증을 OAuth 2.0으로 업데이트:
    • X 앱에 “읽기, 쓰기, Direct Messages 액세스” 권한이 있는지 확인하세요.
    • V2 엔드포인트 사용을 위해 OAuth 2.0으로 전환하세요. 스코프가 변경된 경우 사용자를 다시 인증하세요.
    • 개발자 포털에서 다음을 관리하세요:
      • OAuth 2.0 액세스 토큰
      • Client ID 및 Client Secret
  • 웹훅 확인 또는 재구성:
    • 기존 웹훅 URL을 사용하거나 새로 설정하세요(예: https://your_domain.com/webhook/twitter).
    • V2 Webhooks API 문서를 참고하여 웹훅을 등록 및 관리하세요.
  • 샘플 앱: