메인 콘텐츠로 건너뛰기계정을 음소거하면 해당 계정을 언팔로우하거나 차단하지 않고도 타임라인에서 해당 계정의 게시물을 숨길 수 있습니다. 음소거된 계정은 사용자가 자신을 음소거했다는 사실을 알 수 없으며, 언제든지 음소거를 해제할 수 있습니다. manage mutes 엔드포인트를 사용하면 개발자는 X에서 더 안전한 사용자 경험을 제공할 수 있습니다. manage mutes를 활용한 예로, 특정 주제에 대해 게시할 가능성이 있는 계정을 일정 기간 동안 음소거할 수 있게 해주는 애플리케이션이 있습니다. mutes lookup 엔드포인트를 사용하면 본인 또는 인증된 사용자가 누구를 음소거했는지 확인할 수 있습니다. 이는 음소거된 계정과 상호작용하는 방식을 파악하는 데 유용합니다.
mute lookup으로 비공개 정보를 요청하고, manage mutes로 사용자 대신 작업을 수행하므로, 이러한 엔드포인트는 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE로 인증해야 하며, 앱을 승인한 사용자의 액세스 토큰을 사용해야 합니다. 액세스 토큰은 3-legged OAuth 플로우 (OAuth 1.0a) 또는 Authorization Code with PKCE grant flow (OAuth 2.0)를 사용해 생성할 수 있습니다.
뮤트 조회 엔드포인트를 사용하면 인증된 사용자가 어떤 계정을 뮤트했는지 확인할 수 있습니다. 이 엔드포인트의 요청 한도는 사용자당 15분에 15회입니다.
뮤트 관리 엔드포인트를 사용하면 인증된 사용자를 대신해 지정한 계정을 뮤트하거나 뮤트 해제할 수 있습니다. 이 엔드포인트에는 POST와 DELETE 두 가지 메서드가 있습니다. POST는 계정을 뮤트하고, DELETE는 뮤트를 해제합니다. POST와 DELETE 엔드포인트 모두 사용자 기준 15분당 50회 요청 제한이 적용됩니다.
주의: 사용자가 X 웹/앱에서 뮤트하는 경우에는 15분당 200회 요청 제한이 적용됩니다.
계정 설정
이 엔드포인트에 액세스하려면 다음이 필요합니다.
X API v2 엔드포인트에 대한 액세스 방법은 시작 가이드에서 자세히 알아보세요.