List lookup: standard v1.1과 X API v2 비교
standard v1.1의 GET lists/show 및 GET lists/ownerships 엔드포인트를 사용해 왔다면, 이 가이드는 standard v1.1과 X API v2의 List lookup 엔드포인트 사이의 유사점과 차이점을 이해하는 데 도움이 될 것입니다.- 유사점
- 인증 방식
- Rate limit
- 차이점
- 엔드포인트 URL
- App 및 Project 요구사항
- 요청당 데이터 객체 수 제한
- 응답 데이터 형식
- 요청 매개변수
유사점
인증 두 엔드포인트 버전 모두 OAuth 1.0a User Context와 App only를 모두 지원합니다. 따라서 이전에 standard v1.1 List lookup 엔드포인트 중 하나를 사용했다면 X API v2 버전으로 마이그레이션할 때도 동일한 인증 방식을 계속 사용할 수 있습니다. 선택한 인증 라이브러리/패키지에 따라 다르지만, App only 인증은 시작하기가 가장 쉽고 간단한 요청 헤더로 설정할 수 있습니다. App only Access Token을 생성하는 방법은 이 App only 가이드를 참조하세요. Rate limit차이점
엔드포인트 URL- Standard v1.1 엔드포인트:
- GET https://api.x.com/1.1/lists/show.json (지정된 List 조회)
- GET https://api.x.com/1.1/lists/ownerships.json (지정된 사용자가 소유한 List 조회)
- X API v2 엔드포인트:
- GET https://api.x.com/2/lists/:id (지정된 List 조회)
- GET https://api.x.com/2/users/:id/owned_lists (지정된 사용자가 소유한 List 조회)
- created_at
- follower_count
- member_count
- owner_id
- description
- private
이 새로운 매개변수에 대한 자세한 내용은 각 가이드나 fields와 expansions 사용법 가이드를 읽어보시기 바랍니다.
또한 standard v1.1의 필드를 새로운 v2 필드에 매핑하는 데 도움을 주는 데이터 형식 마이그레이션 가이드도 준비되어 있습니다. 이 가이드는 v2 요청과 함께 특정 필드를 반환하기 위해 전달해야 하는 구체적인 expansion 및 field 매개변수도 제공합니다.
필드 요청 방식의 변경 외에도, X API v2는 Post 및 user 객체를 포함하여 API가 반환하는 객체에 대한 새로운 JSON 설계를 도입하고 있습니다.
- JSON 루트 레벨에서 standard 엔드포인트는 statuses 배열에 Post 객체를 반환하지만, X API v2는 data 배열을 반환합니다.
- Retweeted 및 Quoted “statuses”라는 표현 대신 X API v2 JSON은 Retweeted 및 Quoted Tweet이라는 표현을 사용합니다. contributors 및 user.translator_type과 같은 많은 레거시 및 폐기 예정 필드가 제거되고 있습니다.
- favorites (Post 객체 내) 및 favourites (user 객체 내)를 함께 사용하는 대신, X API v2는 like라는 용어를 사용합니다.
- X는 값이 없는 JSON 값(예: null)은 페이로드에 기록하지 않는 규칙을 채택하고 있습니다. Post와 user 속성은 non-null 값을 가진 경우에만 포함됩니다.
사용자가 소유한 List lookup