채팅 API
채팅 설정 조회
인증된 사용자 채널의 채팅 설정을 조회합니다.
GET /api/openapi/open/v1/chats/settings
- 인증: Access Token (Bearer)
- 필요 Scope:
READ:LIVE_CHAT_SETTINGS
응답
| 필드 | 타입 | 설명 |
|---|---|---|
chatAllowedGroup |
string | "ALL" | "FOLLOWER" | "MANAGER" |
minFollowerMinute |
number | 최소 팔로우 시간 (분). FOLLOWER 모드일 때 적용 |
followerSubscriberChatAllow |
boolean | null | 팔로워 모드에서 구독자 즉시 채팅 허용 여부 |
채팅 설정 변경
인증된 사용자 채널의 채팅 설정을 변경합니다. 전달된 필드만 업데이트됩니다.
PUT /api/openapi/open/v1/chats/settings
- 인증: Access Token (Bearer)
- 필요 Scope:
WRITE:LIVE_CHAT_SETTINGS
요청 본문
전달된 필드만 업데이트됩니다. 모든 필드는 선택사항입니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
chatEmojiMode |
boolean | - | 이모지 전용 모드 여부 |
chatSlowModeSec |
number | - | 채팅 딜레이 (초) |
chatAllowedGroup |
string | - | "ALL" | "FOLLOWER" | "MANAGER" |
minFollowerMinute |
number | - | 최소 팔로우 시간 (분) |
followerSubscriberChatAllow |
boolean | - | 팔로워 모드에서 구독자 즉시 채팅 허용 여부 |
채팅 메시지 전송
인증된 사용자의 채널 라이브 채팅에 메시지를 전송합니다.
POST /api/openapi/open/v1/chats/send
- 인증: Access Token (Bearer)
- 필요 Scope:
WRITE:LIVE_CHAT
요청 본문
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
message |
string | O | 전송할 메시지 (1~100자) |
senderType |
string | - | 발신자 타입. APP (기본값): 애플리케이션 소유자(채널 주인)의 이름으로 전송, USER: 인증된 사용자 본인의 이름으로 전송 |
senderType에 따라 메시지의 발신자가 달라집니다. 메시지가 전송되는 대상 채널은 항상 인증된 사용자의 채널입니다.
APP: 애플리케이션을 생성한 채널 주인의 프로필로 메시지가 표시됩니다.USER: 인증된 사용자 본인의 프로필로 메시지가 표시됩니다.
응답
| 필드 | 타입 | 설명 |
|---|---|---|
messageId |
string | 전송된 메시지 ID |
채팅 공지 등록
인증된 사용자의 채널 라이브 채팅에 공지사항을 등록합니다.
POST /api/openapi/open/v1/chats/notice
- 인증: Access Token (Bearer)
- 필요 Scope:
WRITE:LIVE_CHAT_NOTICE
요청 본문
message와 messageId 중 하나를 반드시 제공해야 합니다. 둘 다 제공하지 않으면 400 에러가 반환됩니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
message |
string | 조건부 | 새 메시지로 공지 등록 시 사용 (1~100자) |
messageId |
string | 조건부 | 기존 메시지를 공지로 등록 시 사용 |