인증
| Method | Description |
|---|---|
| OAuth 2.0 Authorization Code with PKCE | 새 애플리케이션에 권장됩니다 |
| OAuth 1.0a User Context | 레거시 지원용입니다 |
App-Only 인증은 지원되지 않습니다. 반드시 사용자를 대신하여 인증해야 합니다.
필수 스코프 (OAuth 2.0)
| Scope | 필요한 용도 |
|---|---|
mute.read | 뮤트된 계정 조회 |
mute.write | 계정 뮤트 및 해제 |
users.read | 뮤트 관련 스코프와 함께 필요 |
엔드포인트 개요
| Method | Endpoint | Description |
|---|---|---|
| GET | /2/users/:id/muting | 뮤트 중인 계정 목록을 조회합니다 |
| POST | /2/users/:id/muting | 계정을 뮤트합니다 |
| DELETE | /2/users/:source_user_id/muting/:target_user_id | 계정 뮤트를 해제합니다 |
필드와 expansions
기본 응답
{
"data": [
{
"id": "1234567890",
"name": "Example User",
"username": "example"
}
]
}
사용 가능한 필드
user.fields
user.fields
| 필드 | 설명 |
|---|---|
created_at | 계정 생성 날짜 |
description | 프로필 소개 |
profile_image_url | 프로필 이미지 URL |
public_metrics | 팔로워/팔로잉 수 |
verified | 인증 상태 |
expansions
expansions
| 확장 | 설명 |
|---|---|
pinned_tweet_id | 사용자가 고정한 게시물 |
fields가 포함된 예시
cURL
curl "https://api.x.com/2/users/123456789/muting?\
user.fields=username,verified,created_at&\
max_results=100" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# 추가 fields와 함께 뮤트한 사용자 조회
for page in client.users.get_muting(
user_id="123456789",
user_fields=["username", "verified", "created_at"],
max_results=100
):
for user in page.data:
print(f"{user.username} - Verified: {user.verified}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
const paginator = client.users.getMuting("123456789", {
userFields: ["username", "verified", "created_at"],
maxResults: 100,
});
for await (const page of paginator) {
page.data?.forEach((user) => {
console.log(`${user.username} - Verified: ${user.verified}`);
});
}
페이지네이션
cURL
# 첫 번째 요청
curl "https://api.x.com/2/users/123/muting?max_results=100" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
# 페이지네이션 토큰을 사용하는 이후 요청
curl "https://api.x.com/2/users/123/muting?max_results=100&pagination_token=NEXT_TOKEN" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# SDK가 페이지네이션을 자동으로 처리합니다
all_muted = []
for page in client.users.get_muting(user_id="123", max_results=100):
if page.data:
all_muted.extend(page.data)
print(f"Muted {len(all_muted)} users")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
async function getAllMutedUsers(userId) {
const allMuted = [];
// SDK가 페이지네이션을 자동으로 처리합니다
const paginator = client.users.getMuting(userId, { maxResults: 100 });
for await (const page of paginator) {
if (page.data) {
allMuted.push(...page.data);
}
}
return allMuted;
}
// 사용 예
const muted = await getAllMutedUsers("123");
console.log(`Muted ${muted.length} users`);
페이지네이션 가이드
페이지네이션에 대해 자세히 알아보기
동작 방식의 차이
음소거 vs 차단
| 기능 | 음소거 | 차단 |
|---|---|---|
| 상대방 포스트 보기 | 아니요 (숨김) | 아니요 |
| 상대방이 내 포스트 보기 | 예 | 아니요 |
| 상대방이 나를 팔로우 | 예 (팔로우 가능) | 아니요 (해제됨) |
| 상대방이 DM 보내기 | 예 | 아니요 |
| 알림 전송 | 아니요 | 아니요 |
음소거는 비공개입니다. 음소거된 사용자는 알림을 받지 못하며, 자신이 음소거되었는지 알 수 없습니다.
오류 처리
| Status | Error | Solution |
|---|---|---|
| 400 | 잘못된 요청 | 사용자 id 형식을 확인하세요 |
| 401 | 인증되지 않음 | 액세스 토큰을 확인하세요 |
| 403 | 권한 없음 | 스코프와 권한을 확인하세요 |
| 404 | 찾을 수 없음 | 사용자가 존재하지 않습니다 |
| 429 | 요청이 너무 많음 | 기다렸다가 다시 시도하세요 |
다음 단계
빠른 시작
첫 음소거 요청 보내기
차단
음소거 대신 사용자 차단하기
API 참조 문서
전체 엔드포인트 문서
샘플 코드
실행 가능한 코드 예제