X API의 Posts lookup 엔드포인트 비교
v2 Posts lookup 엔드포인트는 standard v1.1 GET statuses/lookup 및 GET statuses/show 엔드포인트를 대체합니다. 이 가이드는 이러한 이전 버전에서 X API v2로 마이그레이션하는 개발자를 위한 것입니다.엔드포인트 비교표
Standard v1.1과 X API v2 비교
standard v1.1 GET statuses/show 및 GET statuses/lookup을 사용해 왔다면, 이 가이드는 standard와 X API v2 Posts lookup 엔드포인트의 공통점과 차이점을 이해하는 데 도움이 됩니다. X API v1.1 데이터 형식과 X API v2 형식의 차이점을 빠르게 확인할 수 있는 시각적 데이터 형식 마이그레이션 도구도 참고하세요.-
공통점
- OAuth 1.0a User Context
- 요청당 게시물 수 제한
- Post 편집 히스토리 및 메타데이터 지원
-
차이점
- 엔드포인트 URL
- App 및 Project 요구사항
- 응답 데이터 형식
- 요청 파라미터
공통점
OAuth 1.0a User Context 인증 방식
standard 엔드포인트는 OAuth 1.0a User Context를 지원하며, 새로운 X API v2 Post lookup 엔드포인트는 OAuth 1.0a User Context와 OAuth 2.0 App-Only를 모두 지원합니다. 따라서 이전에 standard v1.1 Post lookup 엔드포인트 중 하나를 사용하고 있었다면, X API v2 버전으로 마이그레이션하더라도 동일한 인증 방식을 계속 사용할 수 있습니다. App-Only 인증이 아마도 시작하기 가장 쉬운 방법일 것입니다. App Access Token 생성 방법은 이 OAuth 2.0 App-only 가이드를 참고하세요.요청당 게시물 수 제한
v1.1 GET statuses/lookup 엔드포인트는 요청당 최대 100개의 게시물을 지정할 수 있습니다. 이는 GET /tweets 엔드포인트에도 적용됩니다. 전체 100개의 게시물을 지정하려면ids 파라미터를 쿼리 파라미터로 사용하고 Post ID를 쉼표로 구분된 목록으로 전달합니다.
Post 편집 히스토리 및 메타데이터 지원
두 버전 모두 편집 히스토리를 설명하는 메타데이터를 제공합니다. 자세한 내용은 Post lookup API 레퍼런스와 Edit Posts 기본 페이지를 참고하세요.
차이점
엔드포인트 URL
-
Standard v1.1 엔드포인트:
https://api.x.com/1.1/statuses/showhttps://api.x.com/1.1/statuses/lookup
-
X API v2 엔드포인트:
https://api.x.com/2/tweetshttps://api.x.com/2/tweets/:id
App 및 Project 요구사항
X API v2 엔드포인트는 인증을 위해 Project에 연결된 developer App의 자격 증명을 요구합니다. X API v1.1 엔드포인트는 App의 자격 증명이나 App에 연결된 App의 자격 증명을 사용할 수 있습니다.응답 데이터 형식
standard v1.1과 X API v2 엔드포인트 버전의 중요한 차이 중 하나는 페이로드에서 필드가 선택되는 방식입니다. standard 엔드포인트의 경우 많은 응답 필드가 기본적으로 포함되며, 파라미터로 추가 필드를 지정할 수 있습니다. 반면 X API v2는 기본적으로 Postid와 text 필드만 전달합니다. 추가 필드와 객체를 사용하려면 fields 및 expansions 파라미터를 사용해야 합니다. 확장된 필드는 응답의 includes 객체로 반환되며, ID를 매칭하여 기본 Post 객체와 연결할 수 있습니다.
fields와 expansions 사용에 대한 자세한 내용은 fields와 expansions 사용법 가이드를 참고하세요. 데이터 형식 마이그레이션 가이드도 standard v1.1 필드를 새로운 v2 필드에 매핑합니다.
또한 X API v2는 Post 및 user 객체를 포함한 객체에 새로운 JSON 설계를 도입합니다:
- standard 엔드포인트는
statuses배열에 Post 객체를 반환하지만, X API v2는data배열을 사용합니다. - X API v2에서는 “statuses” 용어 대신 Retweeted 및 Quoted Tweets를 사용합니다.
like같은 새로운 용어가favorites및favourites같은 용어를 대체합니다.- 값이 없는(예:
null) 속성은 X API v2 페이로드에 포함되지 않습니다.
conversation_id- 두 개의 새로운 annotations 필드(
context및entities) - 새로운 metrics 필드
- 특정 게시물에 누가 답글을 달 수 있는지 보여주는
reply_setting필드
요청 파라미터
다음 standard v1.1 요청 파라미터는 X API v2에 동등한 것이 있습니다:
X API v2에서 지원되지 않는 특정 standard v1.1 파라미터가 있습니다:
cURL 요청
다음 cURL 요청은 standard v1.1 엔드포인트와 그 v2 대응 엔드포인트를 보여줍니다. 헤더의ACCESS_TOKEN을 app access token으로 교체하세요. v2 엔드포인트의 경우 토큰은 Project 내 developer App에 속해야 합니다.
v1.1의 응답 페이로드는 v2와 다릅니다. v2에서는 fields 및 expansions 파라미터로 다른 필드를 요청할 수 있습니다.
Standard v1.1 GET statuses/lookup과 v2 GET /tweets 엔드포인트
GET statuses/show/:id과 v2 GET /tweets/:id 엔드포인트