v1에서 v2로

리스트 관리: Standard v1.1과 X API v2 비교

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

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

유사점

인증

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

차이점

엔드포인트 URL

• 표준 v1.1 엔드포인트:
  • POST https://api.x.com/1.1/lists/create.json (리스트 생성)
  • POST https://api.x.com/1.1/lists/destroy.json (리스트 삭제)
  • POST https://api.x.com/1.1/lists/update.json (리스트 업데이트)
• X API v2 엔드포인트:

  • POST https://api.x.com/2/lists (리스트 생성)

  • DELETE https://api.x.com/2/lists/:id (리스트 삭제)

  • PUT https://api.x.com/2/lists/:id (리스트 업데이트)

요청 한도

표준 v1.1	X API v2
/1.1/lists/create.json 없음	/2/lists OAuth 1.0a 사용자 컨텍스트 기준 15분당 300회 요청
/1.1/lists/destroy.json 없음	/2/lists/:id OAuth 1.0a 사용자 컨텍스트 기준 15분당 300회 요청
/1.1/lists/update.json 없음	/2/lists/:id OAuth 1.0a 사용자 컨텍스트 기준 15분당 300회 요청

App 및 Project 요구 사항

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

요청 매개변수

다음 표준 v1.1 요청 매개변수는 X API v2에서의 대응 항목입니다:

리스트 생성

표준	X API v2
name	name
mode	private
description	description

리스트 삭제/업데이트

표준	X API v2
owner_screen_name	해당 없음
owner_id	해당 없음
list_id	id
slug	해당 없음

참고: 표준 v1.1 매개변수는 쿼리 매개변수로 전달되지만, X API v2 매개변수는 POST 엔드포인트에서는 본문 매개변수로, DELETE 및 PUT 엔드포인트에서는 경로 매개변수로 전달됩니다.

---

코드 예제

리스트 생성 (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My List", "description": "A great list"}'

리스트 삭제 (v2)

cURL

shellscript

curl -X DELETE "https://api.x.com/2/lists/123456789" \
  -H "Authorization: OAuth ..."