채널 사용자 관리

Get Channel Members

GET https://api.talkplus.io/v1.4/api/channels/:channelId/members

Path Parameters

Name

Type

Description

channelId*

string

Query Parameters

Name

Type

Description

lastUserId

string

Last member user ID to query from (use for pagination)

limit

integer

default: 50

Headers

Name

Type

Description

app-id*

string

App ID

api-key*

string

App API key

{
  "members": [
    {
      "id": "user123",
      "username": "john",
      "profileImageUrl": "http://cnd.test.com/123.jpg",
      "data": {},
      "memberInfo": {},
      "lastReadAt": 1583924400,
      "lastSentAt": 1583924400,
      "updatedAt": 1583924400,
      "createdAt": 1583921400
    }
  ],
  "hasNext": false
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Get Channel Member

GET https://api.talkplus.io/v1.4/api/channels/:channelId/members/:memberId

Path Parameters

Name

Type

Description

channelId*

string

memberId*

string

Headers

Name

Type

Description

app-id*

string

App ID

api-key*

string

App API key

{
  "member": {
      "id": "user123",
      "username": "john",
      "profileImageUrl": "http://cnd.test.com/123.jpg",
      "data": {},
      "memberInfo": {},
      "lastReadAt": 1583924400,
      "lastSentAt": 1583924400,
      "updatedAt": 1583924400,
      "createdAt": 1583921400
    }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Add Channel Members

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/add

Path Parameters

Name

Type

Description

channelId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

Request Body

Name

Type

Description

members*

array

채널 멤버로 추가할 사용자 ID 목록

{
  "channel": {
    "id": "channel123",
    "name": "MyFirstChannel",
    "ownerId": "user123",
    "type": "private",
    "imageUrl": "image url",
    "invitationCode": "",
    "isFrozen": false,
    "hideMessagesBeforeJoin": false,
    "category": "",
    "subcategory": "",
    "privateTag": "",
    "privateData": {},
    "memberCount": 2,
    "maxMemberCount": 100,
    "data": {
      "someMetaKey1": "someMetaValue1",
      "someMetaKey2": "someMetaValue2"
    },
    "members": [
      {
        "id": "user123",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/123.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      },
      {
        "id": "user456",
        "username": "james",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "mutedUsers": [],
    "bannedUsers": [],
    "bots": [],
    "updatedAt": 1583924400,
    "createdAt": 1583921400,
    "unreadCount": 0,
    "lastReadAt": 0,
    "lastMessage": {
      "id": "sdf2l5s9j",
      "channelId": "channel123",
      "userId": "user456",
      "username": "myUsername",
      "profileImageUrl": "http://cdn.test.com/123.jpg",
      "type": "message",
      "text": "Hello world",
      "data": {
        "customField": "customData"
      },
      "parentMessage": {},
      "translations": {},
      "reactions": {"happy": 1},
      "createdAt": 1583921400
    }
  }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Remove Channel Members

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/remove

Path Parameters

Name

Type

Description

channelId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

Request Body

Name

Type

Description

members*

array

채널 멤버 목록에서 제거할 사용자 ID 목록

{
  "channel": {
    "id": "channel123",
    "name": "MyFirstChannel",
    "ownerId": "user123",
    "type": "private",
    "imageUrl": "image url",
    "invitationCode": "",
    "isFrozen": false,
    "hideMessagesBeforeJoin": false,
    "category": "",
    "subcategory": "",
    "privateTag": "",
    "privateData": {},
    "memberCount": 2,
    "maxMemberCount": 100,
    "data": {
      "someMetaKey1": "someMetaValue1",
      "someMetaKey2": "someMetaValue2"
    },
    "members": [
      {
        "id": "user123",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/123.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      },
      {
        "id": "user456",
        "username": "james",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "mutedUsers": [],
    "bannedUsers": [],
    "bots": [],
    "updatedAt": 1583924400,
    "createdAt": 1583921400,
    "unreadCount": 0,
    "lastReadAt": 0,
    "lastMessage": {
      "id": "sdf2l5s9j",
      "channelId": "channel123",
      "userId": "user456",
      "username": "myUsername",
      "profileImageUrl": "http://cdn.test.com/123.jpg",
      "type": "message",
      "text": "Hello world",
      "data": {
        "customField": "customData"
      },
      "parentMessage": {},
      "translations": {},
      "reactions": {"happy": 1},
      "createdAt": 1583921400
    }
  }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Get Users Banned from Channel

GET https://api.talkplus.io/v1.4/api/channels/:channelId/members/banned

Path Parameters

Name

Type

Description

channelId*

string

Query Parameters

Name

Type

Description

lastUserId

string

Last user ID to query from (use for pagination)

limit

integer

default: 50

Headers

Name

Type

Description

app-id*

string

App ID

api-key*

string

App API key

{
  "users": [
    {
      "id": "user123",
      "username": "john",
      "profileImageUrl": "http://cnd.test.com/123.jpg",
      "data": {},
      "memberInfo": {},
      "lastReadAt": 1583924400,
      "lastSentAt": 1583924400,
      "updatedAt": 1583924400,
      "createdAt": 1583921400
    }
  ],
  "hasNext": false
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Ban Channel Members

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/ban

Path Parameters

Name

Type

Description

channelId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

Request Body

Name

Type

Description

members*

array

채널에서 차단할 사용자 ID 목록

{
  "channel": {
    "id": "channel123",
    "name": "MyFirstChannel",
    "ownerId": "user123",
    "type": "private",
    "imageUrl": "image url",
    "invitationCode": "",
    "isFrozen": false,
    "hideMessagesBeforeJoin": false,
    "category": "",
    "subcategory": "",
    "privateTag": "",
    "privateData": {},
    "memberCount": 2,
    "maxMemberCount": 100,
    "data": {
      "someMetaKey1": "someMetaValue1",
      "someMetaKey2": "someMetaValue2"
    },
    "members": [
      {
        "id": "user123",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/123.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
      {
        "id": "user456",
        "username": "james",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "mutedUsers": [],
    "bannedUsers": [
      {
        "id": "user456",
        "username": "james",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "bots": [],    
    "updatedAt": 1583924400,
    "createdAt": 1583921400,
    "unreadCount": 0,
    "lastReadAt": 0,
    "lastMessage": {
      "id": "sdf2l5s9j",
      "channelId": "channel123",
      "userId": "user456",
      "username": "myUsername",
      "profileImageUrl": "http://cdn.test.com/123.jpg",
      "type": "message",
      "text": "Hello world",
      "data": {
        "customField": "customData"
      },
      "parentMessage": {},
      "translations": {},
      "reactions": {"happy": 1},
      "createdAt": 1583921400
    }
  }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Unban Users from Channel

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/unban

Path Parameters

Name

Type

Description

channelId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

Request Body

Name

Type

Description

members*

array

채널 차단 해지할 사용자 ID 목록

{
  "channel": {
    "id": "channel123",
    "name": "MyFirstChannel",
    "ownerId": "user123",
    "type": "private",
    "imageUrl": "image url",
    "invitationCode": "",
    "isFrozen": false,
    "hideMessagesBeforeJoin": false,
    "category": "", 
    "subcategory": "",
    "privateTag": "",
    "privateData": {},
    "memberCount": 2,
    "maxMemberCount": 100,
    "data": {
      "someMetaKey1": "someMetaValue1",
      "someMetaKey2": "someMetaValue2"
    },
    "members": [
      {
        "id": "user123",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/123.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      },
      {
        "id": "user456",
        "username": "james",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "mutedUsers": [],
    "bannedUsers": [],
    "bots": [],
    "updatedAt": 1583924400,
    "createdAt": 1583921400,
    "unreadCount": 0,
    "lastReadAt": 0,
    "lastMessage": {
      "id": "sdf2l5s9j",
      "channelId": "channel123",
      "userId": "user456",
      "username": "myUsername",
      "profileImageUrl": "http://cdn.test.com/123.jpg",
      "type": "message",
      "text": "Hello world",
      "data": {
        "customField": "customData"
      },
      "parentMessage": {},
      "translations": {},
      "reactions": {"happy": 1},
      "createdAt": 1583921400
    }
  }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Get Muted Channel Members

GET /v1.4/api/channels/:channelId/members/muted

Path Parameters

Name

Type

Description

channelId*

string

Query Parameters

Name

Type

Description

lastUserId

string

Last member user ID to query from (use for pagination)

limit

integer

default: 50

Headers

Name

Type

Description

app-id*

string

App ID

api-key*

string

App API key

{
  "members": [
    {
      "id": "user123",
      "username": "john",
      "profileImageUrl": "http://cnd.test.com/123.jpg",
      "data": {},
      "memberInfo": {},
      "lastReadAt": 1583924400,
      "lastSentAt": 1583924400,
      "updatedAt": 1583924400,
      "createdAt": 1583921400
    }
  ],
  "hasNext": false
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Mute Channel Members

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/mute

Path Parameters

Name

Type

Description

channelId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

Request Body

Name

Type

Description

members*

array

채널에서 mute 처리할 사용자 ID 목록

expireInMinutes

int

expireInMinutes 옵션을 사용하면 mute가 N분 후에 자동 해제되도록 지정할 수 있습니다.

expireInMinutes의 기본값은 0입니다 (자동 해제 없음)

{
  "channel": {
    "id": "channel123",
    "name": "MyFirstChannel",
    "ownerId": "user123",
    "type": "private",
    "imageUrl": "image url",
    "invitationCode": "",
    "isFrozen": false,
    "hideMessagesBeforeJoin": false,
    "category": "", 
    "subcategory": "",
    "privateTag": "",
    "privateData": {},
    "memberCount": 1,
    "maxMemberCount": 100,
    "data": {
      "someMetaKey1": "someMetaValue1",
      "someMetaKey2": "someMetaValue2"
    },
    "members": [
      {
        "id": "user123",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/123.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      },
      {
        "id": "user456",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "mutedUsers": [
      "user456"
    ],
    "bannedUsers": [],
    "bots": [],
    "updatedAt": 1583924400,
    "createdAt": 1583921400,
    "unreadCount": 0,
    "lastReadAt": 0,
    "lastMessage": {
      "id": "sdf2l5s9j",
      "channelId": "channel123",
      "userId": "user456",
      "username": "myUsername",
      "profileImageUrl": "http://cdn.test.com/123.jpg",
      "type": "message",
      "text": "Hello world",
      "data": {
        "customField": "customData"
      },
      "parentMessage": {},
      "translations": {},
      "reactions": {"happy": 1},
      "createdAt": 1583921400
    }
  }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Unmute Channel Members

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/unmute

Path Parameters

Name

Type

Description

channelId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

Request Body

Name

Type

Description

members*

array

채널 mute 해지할 사용자 ID 목록

{
  "channel": {
    "id": "channel123",
    "name": "MyFirstChannel",
    "ownerId": "user123",
    "type": "private",
    "imageUrl": "image url",
    "invitationCode": "",
    "isFrozen": false,
    "hideMessagesBeforeJoin": false,
    "category": "", 
    "subcategory": "",
    "privateTag": "",
    "privateData": {},
    "memberCount": 2,
    "maxMemberCount": 100,
    "data": {
      "someMetaKey1": "someMetaValue1",
      "someMetaKey2": "someMetaValue2"
    },
    "members": [
      {
        "id": "user123",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/123.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      },
      {
        "id": "user456",
        "username": "james",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "mutedUsers": [],
    "bannedUsers": [],
    "bots": [],
    "updatedAt": 1583924400,
    "createdAt": 1583921400,
    "unreadCount": 0,
    "lastReadAt": 0,
    "lastMessage": {
      "id": "sdf2l5s9j",
      "channelId": "channel123",
      "userId": "user456",
      "username": "myUsername",
      "profileImageUrl": "http://cdn.test.com/123.jpg",
      "type": "message",
      "text": "Hello world",
      "data": {
        "customField": "customData"
      },
      "parentMessage": {},
      "translations": {},
      "reactions": {"happy": 1},
      "createdAt": 1583921400
    }
  }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Mute All Channel Members (except owner)

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/mute/all

Path Parameters

Name

Type

Description

channelId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

{
  "channel": {
    "id": "channel123",
    "name": "MyFirstChannel",
    "ownerId": "user123",
    "type": "private",
    "imageUrl": "image url",
    "invitationCode": "",
    "isFrozen": false,
    "hideMessagesBeforeJoin": false,
    "category": "", 
    "subcategory": "",
    "privateTag": "",
    "privateData": {},
    "memberCount": 1,
    "maxMemberCount": 100,
    "data": {
      "someMetaKey1": "someMetaValue1",
      "someMetaKey2": "someMetaValue2"
    },
    "members": [
      {
        "id": "user123",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/123.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      },
      {
        "id": "user456",
        "username": "john",
        "profileImageUrl": "http://cnd.test.com/456.jpg",
        "data": {},
        "memberInfo": {},
        "lastReadAt": 1583924400,
        "lastSentAt": 1583924400,
        "updatedAt": 1583924400,
        "createdAt": 1583921400
      }
    ],
    "mutedUsers": [
      "user456"
    ],
    "bannedUsers": [],
    "bots": [],
    "updatedAt": 1583924400,
    "createdAt": 1583921400,
    "unreadCount": 0,
    "lastReadAt": 0,
    "lastMessage": {
      "id": "sdf2l5s9j",
      "channelId": "channel123",
      "userId": "user456",
      "username": "myUsername",
      "profileImageUrl": "http://cdn.test.com/123.jpg",
      "type": "message",
      "text": "Hello world",
      "data": {
        "customField": "customData"
      },
      "parentMessage": {},
      "translations": {},
      "reactions": {"happy": 1},
      "createdAt": 1583921400
    }
  }
}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized"
}

Enable Channel Push Notification for Member

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/:memberId/push/enable

Path Parameters

Name

Type

Description

channelId*

string

memberId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

{}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized
}

Disable Channel Push Notification for Member

POST https://api.talkplus.io/v1.4/api/channels/:channelId/members/:memberId/push/disable

Path Parameters

Name

Type

Description

channelId*

string

memberId*

string

Headers

Name

Type

Description

content-type

string

application/json

app-id*

string

App ID

api-key*

string

App API key

{}

{
  "error": true,
  "code": "1006",
  "message": "Unauthorized
}