메인 콘텐츠로 건너뛰기이 페이지에는 List 게시물 조회 엔드포인트를 시스템에 통합할 때 알아두어야 할 여러 도구와 핵심 개념에 대한 정보가 포함되어 있습니다. 이 페이지는 다음과 같은 섹션으로 구성되어 있습니다:
이 엔드포인트를 통합하는 데 도움이 될 핵심 개념을 살펴보기 전에, 먼저 다음에 익숙해지실 것을 권장합니다:
Postman은 엔드포인트를 테스트하는 데 유용한 도구입니다. 각 Postman 요청에는 사용할 수 있는 항목을 빠르게 파악할 수 있도록 모든 경로 및 본문 매개변수가 포함됩니다. Postman 컬렉션에 대해 더 알아보려면 “Using Postman” 페이지를 방문하세요.
선호하는 프로그래밍 언어로 이 엔드포인트를 빠르게 설정하고 싶으신가요? 시작점으로 활용할 수 있는 다양한 코드 샘플을 GitHub 페이지에서 확인하실 수 있습니다.
커뮤니티에서 제공하는 서드파티 라이브러리를 활용해 시작해 보세요. 적절한 버전 태그를 확인하면 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.
모든 X API v2 엔드포인트는 키와 토큰으로도 알려진 자격 증명 세트를 사용해 요청을 인증해야 합니다. 이 엔드포인트에 대한 요청 인증에는 OAuth 1.0a 사용자 컨텍스트, 앱 전용, 또는 OAuth 2.0 Authorization Code with PKCE 중 하나를 사용할 수 있습니다.
OAuth 1.0a 사용자 컨텍스트는 성공적인 요청을 위해 API 키와 사용자 액세스 토큰 세트를 사용해야 함을 의미합니다. 액세스 토큰은 요청을 수행하려는 대상 사용자와 연관되어 있어야 합니다. 다른 사용자의 액세스 토큰 세트를 생성하려면, 해당 사용자가 3-legged OAuth 플로우를 통해 귀하의 App을 승인해야 합니다.
OAuth 1.0a는 다소 사용이 어려울 수 있습니다. 이 인증 방식에 익숙하지 않다면 라이브러리를 사용하거나 Postman과 같은 도구를 사용하고, 또는 OAuth 2.0이나 앱 전용 방식으로 요청을 인증하는 것을 권장합니다.
OAuth 2.0 Authorization Code with PKCE는 애플리케이션의 스코프에 대한 더 세밀한 제어와 여러 기기에 걸친 인증 플로우를 제공합니다. OAuth 2.0을 사용하면 사용자 대신 특정 권한을 부여하는 세분화된 스코프를 선택할 수 있습니다.
App에서 OAuth 2.0을 사용하려면, 개발자 포털의 App 설정 섹션에 있는 인증 설정에서 이를 활성화해야 합니다.
앱 전용 방식은 요청과 함께 앱 전용 액세스 토큰만 전달하면 됩니다. 앱 전용 액세스 토큰은 Developer 앱 내에서 직접 생성하거나 POST oauth2/token 엔드포인트를 사용해 생성할 수 있습니다.
개발자 포털, 프로젝트 및 Developer 앱
| | |
|---|
| 엔드포인트 | HTTP 메서드 | 요청 한도 |
| /2/lists/:id/tweets | GET | 15분당 900회 요청 |
fields 및 expansions라는 도구 세트를 사용해 API에서 반환받을 데이터를 정확히 선택할 수 있게 합니다. expansions 매개변수는 페이로드에서 참조된 객체를 확장하여 포함합니다. 예를 들어, 목록 게시물 조회에서는 다음 expansions을 가져올 수 있습니다:
fields 매개변수는 다양한 데이터 객체 내에서 받고자 하는 필드를 정확히 선택할 수 있도록 합니다. 이 엔드포인트는 주로 게시물 객체를 반환합니다. 기본적으로 게시물 객체는 id와 text 필드를 반환합니다. tweet.created_at 또는 tweet.lang과 같은 추가 필드를 받으려면 fields 매개변수를 사용해 이를 명시적으로 요청해야 합니다.
fields와 expansions를 함께 사용하는 방법에 대한 가이드를 X API v2 데이터 사전에 추가했습니다.
아래 표는 조회 엔드포인트에서 사용할 수 있는 필드와 expansions를 보여줍니다:
| | |
|---|
| 엔드포인트 | 필드 | Expansions |
| /2/lists/:id/tweets | tweet.fields
user.fields | author_id |
