리스트 멤버 관리

리스트 멤버 관리: standard v1.1과 X API v2 비교

standard v1.1의 POST lists/members/create 및 POST lists/members/destroy 엔드포인트를 사용해 왔다면, 이 가이드는 standard v1.1과 X API v2의 리스트 멤버 관리 엔드포인트 간 유사점과 차이점을 이해하는 데 도움을 주기 위한 것입니다.

• 유사점
  • 인증
• 차이점
  • 엔드포인트 URL
  • App 및 프로젝트 요구 사항
  • HTTP 메서드
  • 요청 한도
  • 요청 매개변수

유사점

인증

두 버전의 엔드포인트는 모두 OAuth 1.0a User Context를 지원합니다. 따라서 이전에 표준 v1.1의 리스트 멤버 관리 엔드포인트 중 하나를 사용해 오셨다면, X API v2로 마이그레이션하더라도 동일한 인증 방식을 계속 사용할 수 있습니다.

차이점

엔드포인트 URL

• Standard v1.1 엔드포인트:
  • POST https://api.x.com/1.1/lists/members/create.json (지정된 리스트에 구성원을 추가합니다)
  • POST https://api.x.com/1.1/lists/members/destroy.json (지정된 리스트에서 구성원을 제거합니다)
• X API v2 엔드포인트:

  • POST https://api.x.com/2/lists/:id/members (지정된 리스트에 구성원을 추가합니다)

  • DELETE https://api.x.com/2/lists/:id/members/:user_id (지정된 리스트에서 구성원을 제거합니다)

요청 한도

Standard v1.1	X API v2
/1.1/lists/members/create.json none	/2/lists/:id/members OAuth 1.0a User Context로 15분당 300회 요청 OAuth 2.0 Authorization Code with PKCE로 15분당 300회 요청
/1.1/lists/members/destroy.json none	/2/lists/:id/members/:user_id OAuth 1.0a User Context로 15분당 300회 요청 OAuth 2.0 Authorization Code with PKCE로 15분당 300회 요청

App 및 Project 요구 사항

X API v2 엔드포인트를 사용하려면 요청을 인증할 때 Project와 연결된 developer App의 자격 증명을 사용해야 합니다. 모든 X API v1.1 엔드포인트는 App 또는 Project와 연결된 App의 자격 증명을 사용할 수 있습니다.

요청 매개변수

다음 Standard v1.1 요청 매개변수는 X API v2에서 다음과 같이 매핑됩니다.

Standard v1.1	X API v2
list_id	id
slug	해당 없음
screen_name	해당 없음
owner_screen_name	해당 없음
owner_id	해당 없음