메인 콘텐츠로 건너뛰기
이 페이지에는 mutes 엔드포인트를 시스템에 통합할 때 알아두어야 할 여러 도구와 핵심 개념에 대한 정보가 담겨 있습니다. 이 페이지는 다음과 같은 섹션으로 구성되어 있습니다:

​
유용한 도구

이 엔드포인트를 통합하는 데 도움이 될 핵심 개념을 살펴보기 전에 다음에 먼저 익숙해지시길 권장합니다.

​
Postman

Postman은 엔드포인트를 테스트하는 데 유용한 도구입니다. 각 Postman 요청에는 제공되는 항목을 빠르게 파악할 수 있도록 모든 경로 및 본문 매개변수가 포함되어 있습니다. Postman 컬렉션에 대해 더 알아보려면 “Postman 사용하기” 페이지를 방문하세요. 

​
코드 샘플

선호하는 프로그래밍 언어로 이 엔드포인트를 설정하려고 하시나요? 시작점으로 활용할 수 있는 다양한 코드 샘플을 GitHub 페이지에서 확인할 수 있습니다.

​
서드파티 라이브러리

커뮤니티에서 제공하는 서드파티 라이브러리를 활용해 시작해 보세요. 올바른 버전 태그를 확인하면 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.

​
핵심 개념

​
인증

모든 X API v2 엔드포인트는 키와 토큰으로도 불리는 자격 증명으로 요청을 인증해야 합니다. 이러한 엔드포인트에 대한 요청 인증에는 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE 중 하나를 사용할 수 있습니다.  OAuth 1.0a 사용자 컨텍스트를 사용하려면 API 키, 사용자 액세스 토큰, 그리고 몇 가지 추가 매개변수를 활용해 요청에 포함할 Authorization 헤더를 생성해야 합니다. 액세스 토큰은 해당 요청을 위임받은 사용자와 연계되어 있어야 합니다. 다른 사용자의 액세스 토큰 세트를 생성하려면, 그 사용자가 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 설정 섹션에 있는 App의 인증 설정에서 해당 기능을 활성화해야 합니다.

​
개발자 포털, 프로젝트, 그리고 Developer 앱

X API v2 엔드포인트에서 작동하는 인증 자격 증명을 받으려면 개발자 계정에 가입하고 해당 계정 내에 프로젝트를 설정한 뒤, 그 프로젝트 안에 Developer 앱을 생성해야 합니다. 그런 다음 Developer 앱에서 키와 토큰을 확인할 수 있습니다.  

​
요청 한도

매일 수천 명의 개발자가 X API에 요청을 보냅니다. 이러한 대량의 요청을 관리하기 위해 각 엔드포인트에는 요청 한도가 적용되어, 앱 또는 인증된 사용자를 대신해 보낼 수 있는 요청 수가 제한됩니다.  이러한 엔드포인트는 사용자 수준으로 한도가 적용됩니다. 즉, 여러분이 요청을 보내는 인증된 사용자는 어떤 Developer 앱을 사용하더라도 해당 엔드포인트를 호출할 수 있는 횟수가 일정하게 제한됩니다. POST 및 DELETE 메서드의 경우 엔드포인트별로 15분당 50회의 사용자 요청 한도가 있습니다. 반면 GET 메서드의 경우 한도는 15분당 15회입니다.  

​
필드와 expansions

X API v2 GET 엔드포인트는 fields 및 expansions라는 도구 세트를 통해 API에서 반환받을 데이터를 정확하게 선택할 수 있게 합니다. expansions 파라미터를 사용하면 페이로드에서 참조된 객체를 확장해 포함시킬 수 있습니다. 예를 들어, 이 엔드포인트에서는 다음 expansions을 가져올 수 있습니다:
  • pinned_tweet_id
fields 파라미터를 사용하면 서로 다른 데이터 객체 내에서 받고자 하는 정확한 필드를 선택할 수 있습니다. 이 엔드포인트는 주로 User 객체를 반환합니다. 기본적으로 User 객체는 id, name, username 필드를 반환합니다. user.created_at 또는 user.entities와 같은 추가 필드를 받으려면 fields 파라미터로 해당 필드를 명시적으로 요청해야 합니다. 필드와 expansions를 함께 사용하는 방법에 대한 가이드를 X API v2 데이터 사전에 추가했습니다. 뮤트 조회는 매우 많은 데이터를 반환할 수 있습니다. 언제나 일관되고 높은 성능의 결과를 제공하기 위해 페이지네이션을 사용합니다. 페이지네이션은 단일 응답으로 반환하기에는 결과가 많은 X API v2 엔드포인트에서 제공되는 기능입니다. 이런 경우 데이터는 일련의 ‘페이지’로 나누어 반환됩니다. 결과를 페이지네이션하는 방법에 대해 자세히 알아보세요.
참고: 사용자가 X에서 뮤트한 경우, 15분당 200건의 요청 제한이 적용됩니다.