文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 用户注册开通/ 批量用户开通查询 - GetBatchRegisterUserResult
更新时间：2026-04-16 GMT+08:00
查看PDF
分享

批量用户开通查询 - GetBatchRegisterUserResult

功能介绍

批量用户开通任务查询

授权信息

当前API调用无需身份策略权限。

URI

GET /koodrive/ose/v1/user/batchRegister/get

表1 Query参数

参数

是否必选

参数类型

描述

taskId

是

String

任务ID

cursor

否

String

当前页游标，由前一个响应的nextCursor获取

pageSize

否

Integer

每页显示数量

取值范围：[1, 1000]

默认为1000

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

参数解释：

AK/SK鉴权方式生成的签名

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

X-Date

是

String

参数解释：

日期，用于app鉴权，格式为yyyyMMdd‘T’HHmmss‘Z’

约束限制：

距当前时间15分钟以内，不能晚于当前时间

取值范围：

不涉及

默认值：

不涉及

X-User-Id

是

String

参数解释：

KooDrive侧用户id，用于app鉴权

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

X-Traceid

否

String

参数解释：

业务跟踪id（必须58位）

约束限制：

不涉及

取值范围：

长度为58位

默认值：

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

String

错误码

msg

String

错误描述

data

data object

开通用户结构化响应
表4 data

参数

参数类型

描述

nextPageCursor

String

下一个分页游标值

registerList

Array of registerList objects

注册用户列表

taskInfo

taskInfo object

任务信息
表5 registerList

参数

参数类型

描述

id

String

子任务ID

userId

String

注册成功后的用户ID

phone

String

用户手机号

code

String

错误码，注册失败时须填写

reason

String

错误原因，注册失败时须填写
表6 taskInfo

参数

参数类型

描述

taskId

String

任务ID

status

String

任务状态

totalCount

Integer

任务总数

successCount

Integer

成功数量

failCount

Integer

失败数量

skipCount

Integer

跳过数量

请求示例

GET /koodrive/ose/v1/user/batchRegister/get?taskId=1882735962480556672&cursor=0&pageSize=1

响应示例

状态码：200

批量用户开通查询响应

{
  "data" : {
    "taskInfo" : {
      "taskId" : "1895065728646757504",
      "status" : "2",
      "totalCount" : 2,
      "successCount" : 1,
      "failCount" : 0,
      "skipCount" : 1
    },
    "registerList" : [ {
      "id" : "1895065728646757504",
      "userId" : "1895065729401744000",
      "phone" : "12345557"
    }, {
      "id" : "1895065728646757504",
      "userId" : "1844090530019957504",
      "phone" : "12345557",
      "code" : "40000009",
      "reason" : "The user already exists."
    } ],
    "code" : 0,
    "msg" : "success"
  },
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

批量用户开通查询响应
父主题： 用户注册开通