차단/추방 API
사용자 추방
인증된 사용자의 채널에서 특정 사용자를 추방합니다.
POST /api/openapi/open/v1/restrict-channels
- 인증: Access Token (Bearer)
- 필요 Scope:
WRITE:USER_BLOCK
요청 본문
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
targetChannelId |
string | O | 추방할 사용자의 채널 ID |
추방 사용자 목록 조회
인증된 사용자의 채널에서 추방된 사용자 목록을 조회합니다. 커서 기반 페이지네이션을 사용합니다.
GET /api/openapi/open/v1/restrict-channels
- 인증: Access Token (Bearer)
- 필요 Scope:
READ:USER_BLOCK
Query 파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
size |
number | 20 |
페이지 크기 (1~50) |
next |
string | - | 다음 페이지 커서 값 |
응답 (content.data 배열 항목)
| 필드 | 타입 | 설명 |
|---|---|---|
restrictedChannelId |
string | 추방된 사용자의 채널 ID |
restrictedChannelName |
string | 추방된 사용자의 채널 이름 |
restrictedChannelHandle |
string | 추방된 사용자의 채널 핸들 (슬러그) |
createdDate |
string | 추방 일시 (ISO 8601) |
releaseDate |
string | null | 추방 만료 일시. 영구 추방 시 null |
추방 해제
인증된 사용자의 채널에서 특정 사용자의 추방을 해제합니다.
DELETE /api/openapi/open/v1/restrict-channels
- 인증: Access Token (Bearer)
- 필요 Scope:
WRITE:USER_BLOCK
요청 본문
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
targetChannelId |
string | O | 추방 해제할 사용자의 채널 ID |