통합 가이드

Blocks 엔드포인트 통합을 위한 핵심 개념과 모범 사례

이 가이드는 blocks 엔드포인트를 애플리케이션에 통합하는 데 필요한 핵심 개념을 다룹니다.

---

​

인증

차단(Block) 엔드포인트에는 사용자 인증이 필요합니다:

Method	Description
OAuth 2.0 Authorization Code with PKCE	새로운 애플리케이션에 권장됩니다
OAuth 1.0a User Context	기존 방식(레거시) 지원용

App-Only 인증은 지원되지 않습니다. 반드시 사용자 계정을 대신하여 인증해야 합니다.

​

필수 스코프(OAuth 2.0)

Scope	필요한 작업
block.read	차단된 계정 조회
block.write	계정 차단 및 차단 해제
users.read	block 관련 스코프와 함께 필요

---

​

엔드포인트 개요

Method	Endpoint	Description
GET	/2/users/:id/blocking	차단된 계정 목록 조회
POST	/2/users/:id/blocking	계정 차단
DELETE	/2/users/:source_user_id/blocking/:target_user_id	계정 차단 해제

---

​

필드 및 expansions

​

기본 응답

{
  "data": [
    {
      "id": "1234567890",
      "name": "Example User",
      "username": "example"
    }
  ]
}

​

사용 가능한 필드

user.fields

필드	설명
created_at	계정 생성 일시
description	사용자 소개
profile_image_url	프로필 이미지 URL
public_metrics	팔로워/팔로잉 수
verified	인증 상태

expansions

확장	설명
pinned_tweet_id	사용자가 고정해 둔 게시물

---

​

차단하면 어떻게 되나요

상대방이 할 수 없는 것

• (로그아웃한 상태가 아니라면) 내 포스트 보기
• 나를 팔로우하기
• 나에게 DM 보내기
• 나를 리스트에 추가하기
• 사진에서 나를 태그하기

내가 할 수 없는 것

• 상대방의 포스트 보기
• 상대방을 팔로우하기
• 상대방에게 DM 보내기

나를 팔로우하는 사용자를 차단하면, 그 사용자는 자동으로 팔로우가 해제됩니다.

---

​

페이지네이션

차단 목록이 많은 사용자의 경우 결과가 페이지네이션 방식으로 제공됩니다:

cURL

shellscript

# 첫 번째 요청
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# 페이지네이션 토큰을 사용한 다음 요청
curl "https://api.x.com/2/users/123/blocking?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

오류 처리

Status	오류	해결 방법
400	잘못된 요청	사용자 ID 형식을 확인하세요
401	인증되지 않음	액세스 토큰을 확인하세요
403	권한 없음	scope 및 권한을 확인하세요
404	찾을 수 없음	사용자가 존재하지 않습니다
429	요청이 너무 많음	잠시 기다렸다가 다시 시도하세요

---

​

다음 단계

빠른 시작

첫 blocks 요청을 만들어 보세요

Mutes

차단 대신 사용자를 뮤트하세요

API 참조 문서

전체 엔드포인트 문서

샘플 코드

실행 가능한 코드 예제