嘟哩开放平台
简体中文
繁體中文
English
快速开始 开放接口 嘟哩官网
模板

创建群组


请求说明

POST方式请求URL:
http://[SERVER:9022]/v1/group/group_create?access_token={access_token}


请求示例

{
"org_id": "100000",
"creator_account_id": "5000132279",
"group_name":"",
"account_list": [
"100000-5000132282",
"100000-5000132283"
]
}


请求参数

参数

类型

是否必填

说明

org_id

string

Y

组织id

creator_account_id

string

Y

创建者id


group_name

string

Y

群组名称(不超过32个中、英文字符)

account_list

string[]

Y

群成员数组

"100000-5000132282" 代表:

100000:[组织id]

5000132282:[用户id]


返回结果示例
{

{
"code": 0,
"msg": "ok",
"data": {
"group_id":"50012712",
"group_name":"项目组",
"group_type":"2",
"group_announce":"公告xx",
"group_count":"4",
"group_icon":"",
"group_invite_url":"u.me/joinchat/5000132292/B3MQRU8J",
"group_members":[
{
"org_id":"100000",
"account_id":"20000192",
"status":"1",
"nick_name":"lucy",
"name_in_group":"lucyme",
"is_group_owner":true,
"is_group_manager":false,
"avatar":"/chat/avatar/20241106/222.png",
"phone":"",
"join_group_time":"2023-01-11 11:43:56",
"last_login_time":"2024-06-11 11:43:56",
"last_offline_time":"2024-06-11 12:43:58"
},
...
]
}
}

结果字段说明

参数

类型

说明

data


群信息

group_id

string

群组id

group_name

string

群组名称

group_type

string

群组类型:

1:

2:

group_announce

string

群公告

group_count

string

群人数

group_icon

string

群头像地址

group_invite_url

string

群邀请地址

group_members


群成员

org_id

string

组织(公司)id

account_id

string

用户账号id

status

int

用户账号状态"1":正常,“2”:禁用,“3”:离职

nick_name

string

用户昵称

name_in_group

string

用户在群昵称

is_group_owner

boolean

是否为群主:

true:是

false:否

is_group_manager

boolean

是否为群管理员

true:是

false:否

avatar

string

头像地址

phone

string

手机号码

join_group_time

string

入群时间

last_login_time

string

最后登录时间 yyyy-MM-dd HH:mm:ss

last_offline_time

string

最近离线时间yyyy-MM-dd HH:mm:ss


状态码

code

message

说明

100111

(同添加成员错误码)

Invalid account

无效的成员

100130

Invalid group name

无效的群组名