유용한 도구
이 엔드포인트를 통합하는 데 도움이 될 핵심 개념을 살펴보기 전에, 다음 항목들에 익숙해지시길 권장합니다:Postman
Postman은 엔드포인트를 테스트할 때 사용할 수 있는 훌륭한 도구입니다. 각 Postman 요청에는 모든 path 및 body 파라미터가 포함되어 있어 사용 가능한 옵션을 빠르게 파악할 수 있습니다. Postman 컬렉션에 대해 자세히 알아보려면 “Using Postman” 페이지를 참고하세요.코드 샘플
원하는 프로그래밍 언어의 코드로 이 엔드포인트 사용을 시작하고 싶으신가요? 시작점으로 활용할 수 있는 다양한 코드 샘플을 Github 페이지에서 제공합니다.서드파티 라이브러리
시작에 도움이 되도록 커뮤니티의 서드파티 라이브러리를 활용해 보세요. 적절한 버전 태그를 확인하여 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.핵심 개념
인증
모든 X API v2 엔드포인트는 keys and tokens라고도 부르는 자격 증명 세트로 요청을 인증해야 합니다. Retweets lookup 엔드포인트에 대한 요청 인증에는 OAuth 1.0a User Context 또는 OAuth 2.0 Bearer Token 중 어느 것이든 사용할 수 있습니다. manage Retweets 엔드포인트는 OAuth 1.0a User Context 사용이 필요합니다. 즉, 요청을 성공적으로 보내려면 API keys 세트와 user access token을 사용해야 합니다. Access token은 요청을 대신하는 사용자와 연결되어 있어야 합니다. 다른 사용자를 위한 access token 세트를 생성하려면, 해당 사용자가 3-legged OAuth 흐름을 사용하여 App을 승인하거나 인증해야 합니다. OAuth 1.0a는 사용이 까다로울 수 있다는 점에 유의하세요. 이 인증 방식에 익숙하지 않다면 라이브러리를 사용해 요청을 올바르게 인증하는 것을 권장합니다. 참고 다음 필드를 요청하는 경우 OAuth 1.0a User Context가 필요합니다:- tweet.fields.non_public_metrics
- tweet.fields.promoted_metrics
- tweet.fields.organic_metrics
- media.fields.non_public_metrics
- media.fields.promoted_metrics
- media.fields.organic_metrics
Developer Console, Projects, developer Apps
X API v2 엔드포인트에서 동작하는 인증 자격 증명 세트를 얻으려면 developer account에 가입하고, 해당 계정 내에서 Project를 설정하고, 그 Project 내에서 developer App을 생성해야 합니다. 그런 다음 developer App에서 keys and tokens를 확인할 수 있습니다.Rate limit
매일 수천 명의 개발자가 X API에 요청을 보냅니다. 이러한 대량의 요청을 관리하기 위해 각 엔드포인트에 rate limit이 설정되어 있으며, 이는 앱이나 인증된 사용자를 대신하여 만들 수 있는 요청 수를 제한합니다. manage Retweets 엔드포인트는 사용자당 15분당 50 요청으로 제한됩니다. 또한 POST 엔드포인트의 경우 사용자 및 앱당 3시간 창당 300 요청으로 제한됩니다. Retweets lookup 엔드포인트의 경우 15분 창당 75 요청으로 제한됩니다. 또한 이 엔드포인트는 가장 최근 100명의 Retweeting 사용자만 반환합니다.Fields 및 expansions
X API v2에서는 fields와 expansions라고 하는 도구 세트를 사용해 API에서 반환할 데이터를 정확히 선택할 수 있습니다. expansion 파라미터를 사용하면 페이로드에서 참조되는 객체를 확장할 수 있습니다. 예를 들어 이 엔드포인트에서는 다음과 같은 expansions를 가져올 수 있습니다:- attachments.poll_ids
- attachments.media_keys
- author_id, entities.mentions.username
- geo.place_id
- in_reply_to_user_id,
- referenced_tweets.id,
- referenced_tweets.id.author_id
코드 예시
게시물을 리트윗한 사용자 가져오기
cURL
게시물 리트윗
cURL