批量启用企业成员
API 说明
批量启用指定的企业成员。被启用的成员将恢复正常状态,可以登录和使用企业服务。
注意事项:
- 仅支持应用身份(
app_access_token)调用,不支持用户身份。 - 单次请求最多支持 100 个用户 ID。
- 该接口为全量操作:所有
user_ids要么全部成功,要么全部失败,不支持部分成功。 - 仅支持
active(正常)和disabled(已禁用)状态的用户。若列表中包含未激活(notactive)等其他状态的用户,接口会返回错误。 - 幂等性:已处于正常状态的用户可以重复启用,不会报错,状态保持不变。
- 接口会逐个校验每个
user_id是否在应用的通讯录可见范围内,任一用户不可见时返回 403 错误。 - 启用时会自动去除用户名中的"(已禁用)"后缀。
- 对于多账号企业和分发企业,启用成员时会同步解封对应的账号。
使用限制:
- 需要通讯录管理权限(
kso.contact.readwrite)才能调用该接口。
请求说明
| 字段 | 值 |
|---|---|
| 请求地址 | https://openapi.wps.cn/v7/users/batch_enable |
| HTTP 方法 | POST |
| 签名方式 | KSO-1 |
| 限频策略 | 应用 10次/秒 |
| 权限要求 | 查询和管理通讯录信息(应用授权) kso.contact.readwrite |
请求头(Headers)
| Header 名称 | 参数类型 | 是否必填 | 可选值 | 限制 | 示例 | 描述 |
|---|---|---|---|---|---|---|
| Content-Type | string | 是 | application/json | 固定为 application/json | application/json | 请求内容类型 |
| X-Kso-Date | string | 是 | - | 必须符合 RFC1123 规范 | Thu, 29 May 2026 08:00:00 GMT | RFC1123 格式的日期时间 |
| X-Kso-Authorization | string | 是 | - | - | KSO-1 AK…:… | KSO-1 签名值,详见 签名方法 |
| Authorization | string | 是 | - | 必须以 Bearer 开头 | Bearer {access_token} | 授权凭证,格式为:Bearer {access_token},获取方式详见 认证授权概述 |
请求体(Body)
| 参数名称 | 参数类型 | 是否必填 | 可选值 | 限制 | 示例 | 描述 |
|---|---|---|---|---|---|---|
| user_ids | array[string] | 是 | - | 长度[1,100];每项字符长度[1,128] | ["uid_001", "uid_002"] | 要启用的用户 ID 列表 |
请求示例
cURL
bash
curl -X POST "https://openapi.wps.cn/v7/users/batch_enable" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-H "X-Kso-Date: Thu, 29 May 2026 08:00:00 GMT" \
-H "X-Kso-Authorization: {kso1_signature}" \
-d '{
"user_ids": ["uid_001", "uid_002"]
}'
响应体(Response)
| 参数名称 | 参数类型 | 可选值 | 限制 | 描述 |
|---|---|---|---|---|
| code | integer | - | - | 响应代码。非 0 表示失败,参照《状态码说明》 |
| msg | string | - | 最大长度 128 | 响应信息 |
响应示例
json
{
"code": 0,
"msg": "success"
}
错误码
| HTTP状态码 | 错误码 | 错误描述 | 排查建议 |
|---|---|---|---|
| 400 | 400000002 | 请求参数格式有误 | 检查请求体 JSON 格式是否正确;确认 user_ids 为非空字符串数组且长度不超过 100 |
| 400 | 400000003 | 请求参数取值无效 | 检查 user_ids 中的用户 ID 格式是否正确;user_ids 数量不能超过 100 |
| 400 | 400001006 | 用户不存在 | user_ids 中包含不存在的用户 ID,或用户状态非 active/disabled(如未激活用户不支持启用) |
| 401 | 401000001 | access_token 无效或已过期 | 检查 Authorization 头中的 token 是否正确,是否已过期,需重新获取 |
| 403 | 403000001 | 权限不足 | 确认应用已被授予 kso.contact.readwrite 权限;确认 user_ids 中的所有用户均在应用的通讯录可见范围内 |
| 429 | 429000001 | 请求频率超限 | 降低请求频率 |
| 500 | 500000004 | 服务内部错误 | 请稍后重试,若持续出现请联系技术支持 |