채널 생성
Create Channel
POST
https://api.talkplus.io/v1.4/api/channels/create
data의 경우, 최대 5개의 key-value pair를 입력할 수 있습니다. key의 최대 size는 128자 이고 최대 value size는 1024자입니다. Key, value 둘 다 문자열이어야 합니다.
Headers
Name | Type | Description |
---|---|---|
content-type | string | application/json |
api-key* | string | App API key |
app-id* | string | App ID |
Request Body
Name | Type | Description |
---|---|---|
name | string | 채널명 |
ownerId | string | 채널을 소유할 사용자 ID (URI valid한 값만 허용. 미지정시, REST API로만 채널 수정 가능) |
type* | string | 채널 타입 (private, public, invitationOnly) |
channelId | string | 미설정시, 서버에서 랜덤 ID 생성 |
reuseChannel | boolean | 아래 설명 참고 |
invitationCode | string | Required if channel type is 'invitationOnly' |
members | array | Array of user IDs (string). Channel owner added by default. |
imageUrl | string | 채널 이미지 URL |
data | object | Key-value 형식의 채널 메타 정보 |
maxMemberCount | integer | 채널 최대 인원수. - super channel: default: -1(무제한), min: 1, max: 제한 없음) - 그 외: default: 100, min: 1, max: 100 |
hideMessagesBeforeJoin | boolean | member에게 가입 이전 시점의 메시지를 숨길지 여부 |
category | string | 채널 검색 시 사용할 필터. 최대 32자 |
subcategory | string | 채널 검색 시 사용할 서브필터. category가 먼저 설정되어 있어야 함. 최대 32자. |
채널 타입의 경우 private, public, invitationOnly 타입을 지원합니다.
type과 members 필드는 필수 입니다.
ownerId 필드는 실제로 존재하는 사용자id를 넣어야 합니다. (대시보드의 어드민 계정은 실제 존재하는 사용자id가 아닙니다)
invitationOnly 타입의 경우 invitationCode도 추가적으로 필수 필드입니다.
Type | 정의값 | Join 가능 여부 |
PRIVATE | private | 불가 |
PUBLIC | public | 가능 |
INVITATION ONLY | invitationOnly | 가능, Invitation Code 필요 |
BROADCAST | broadcast | 가능 |
SUPER_PRIVATE | super_private | 가능 |
SUPER_PUBLIC | super_public | 가능 |
PRIVATE 타입의 경우 채널 id와 참여 사용자(targetIds)가 동일한 경우 reuseChannel 파라미터를 true로 설정하여 기존 생성된 채널을 재사용할 수 있습니다. 이는 1:1 대화를 구현하는데 유용하게 사용할 수 있습니다.
PUBLIC, SUPER_PUBLIC 타입 채널에 ban당하지 않은 사용자는 누구나 가입할 수 있습니다.
INVITATION_ONLY 타입의 경우 invitationCode를 제공해야 채널 가입이 가능합니다.
BROADCAST 타입의 경우:
채널 owner가 메시지 발송 시 채널 멤버 모두에게 메시지가 발송됩니다.
채널 owner가 아닌 채널 멤버가 메시지 발송 시 채널 owner에게만 메시지가 전달됩니다.
채널 생성 시, ownerId를 반드시 지정해 주어야 합니다.
SUPER_PRIVATE, SUPER_PUBLIC 타입의 경우,
최대 멤버 제한수를 100명 이상으로 설정할 수 있습니다.
최대 멤버 제한수를 -1로 설정하면 멤버를 무제한으로 추가할 수 있습니다.
members와 bannedUsers 필드에 사용자 정보가 채워져서 내려오는 일반 채널과 달리:
members와 bannedUsers 필드는 빈 상태로 내려옵니다.
SUPER 채널 타입 예제
Last updated