Skip to content
Home » API创建、编辑成员

API创建、编辑成员

  • by

API创建成员功能适用于需要自动化创建成员账户的场景。无须人工介入，用户可以使用API创建成员链接，通过在线API接口，快速为多个新成员自动创建DICloak账号，实现高效的成员账户管理。

1、打开成员列表

打开并登录DICloak软件，在左侧导航栏找到【团队管理】，进入【成员列表】页面，点击“API创建”。

2、创建API链接

设置新成员统一使用的权限设置，即可查看和操作的环境对应的“环境分组”，以及新成员所属的“成员分组”以及“成员身份”。设置完成点击“确定”。

3、使用API链接创建成员

如图所示，表示API链接创建完成，“复制”链接，通过在线 API 接口自动创建成员账号。

基于 HTTPS 协议的 API 接口请求范例：

” https://dicloak.com/gin/v1/api/member/open?token=xxxxx-xxxxxxxxx&id=xxxxxxxxxxxxxxxxxxx&name=aaaaa&account=mcdl5569&password=M12345678&remark=%E5%A4%87%E6%B3%A8&days=30 “

以下为可选的请求参数，您可以根据需要自行配置：

  • name：成员名称 (仅内部可见)；不传则随机生成；非必选
  • account：登录账号名 (字母或数字，6-20位)；不传则随机生成；非必选
  • password：登录密码 (须包含字母+数字，8-25位)；不传则随机生成；非必选
  • remark：成员备注信息；非必选
  • days：n天后自动停用账号；不传则不开启到期停用；非必选

4、管理API链接

同样在【团队管理】>【成员列表】中，点击“API链接管理”。

可管理历史创建的API链接，支持删除或编辑API链接设置。

5、使用API链接编辑成员

可通过 API 编辑单个成员账号信息（此功能暂时只对超管开放）。

使用场景：以共享账号场景为例，支持通过编程方式调用 API，即当您成员续订服务时，可通过调用API延长DICloak成员账号的使用时长；当成员订阅到期，可通过API停用成员账号。

具体请求如下：

  • 请求接口: https://gin-server.dicloak.com/gin/v1/api/member/open/edit
  • 请求方式：GET。
  • 可编辑的具体参数见下表：
参数类型是否必填名称
member_idString是成员ID
tokenString是请求密钥。
statusString否成员状态（DISABLED停用 ENABLED正常））
passwordString否成员密码（仅内部成员才可重置密码)
disuse_enableBoolean否是否开启到期停用 true:启用 false:关闭
time_zoneString否disuse_enable为true时填写对应时区。枚举值请参考文档： https://help.dicloak.com/dicloak-api-appendix/#nav9
disuse_timeString否disuse_enable为true时填写对应过期时间，时间格式（YYYY-MM-dd HH:mm:ss）

带参请求示例：

{
“member_id”: “1866014140000000000”,
“token”: “xMMm12cG9BeG45bASDJKLGADHJKVkyVHZNalZjTjY4c”,
“disuse_time”: “2025-09-10 12:00:00”,
“time_zone”: “America/Adak”,
“disuse_enable”: true
“status”: “ENABLED”,
“password”: “Test12345678”
}

对应的响应示例：

{
“code”:0,
“msg”:”success”,
“data”:
{
“member_id”:”1866014140000000000″,
“disuse_enable”:true,
“disuse_time”:”2025-09-15 12:00:00″,
“time_zone”:”America/Adak”,
“status”:”ENABLED”,
“password”:null
},
“next”:null
}

注意，如果返回结果中，相关字段值为Null，则说明该字段未被修改，您以此判断成员是否编辑成功，例如下图所示