批量启用企业成员

API 说明

批量启用指定的企业成员。被启用的成员将恢复正常状态,可以登录和使用企业服务。

注意事项

使用限制

请求说明

字段
请求地址https://openapi.wps.cn/v7/users/batch_enable
HTTP 方法POST
签名方式KSO-1
限频策略应用 10次/秒
权限要求查询和管理通讯录信息(应用授权) kso.contact.readwrite

请求头(Headers)

Header 名称参数类型是否必填可选值限制示例描述
Content-Typestringapplication/json固定为 application/jsonapplication/json请求内容类型
X-Kso-Datestring-必须符合 RFC1123 规范Thu, 29 May 2026 08:00:00 GMTRFC1123 格式的日期时间
X-Kso-Authorizationstring--KSO-1 AK…:…KSO-1 签名值,详见 签名方法
Authorizationstring-必须以 Bearer 开头Bearer {access_token}授权凭证,格式为:Bearer {access_token},获取方式详见 认证授权概述

请求体(Body)

参数名称参数类型是否必填可选值限制示例描述
user_idsarray[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)

参数名称参数类型可选值限制描述
codeinteger--响应代码。非 0 表示失败,参照《状态码说明》
msgstring-最大长度 128响应信息

响应示例

json
{
  "code": 0,
  "msg": "success"
}

错误码

HTTP状态码错误码错误描述排查建议
400400000002请求参数格式有误检查请求体 JSON 格式是否正确;确认 user_ids 为非空字符串数组且长度不超过 100
400400000003请求参数取值无效检查 user_ids 中的用户 ID 格式是否正确;user_ids 数量不能超过 100
400400001006用户不存在user_ids 中包含不存在的用户 ID,或用户状态非 active/disabled(如未激活用户不支持启用)
401401000001access_token 无效或已过期检查 Authorization 头中的 token 是否正确,是否已过期,需重新获取
403403000001权限不足确认应用已被授予 kso.contact.readwrite 权限;确认 user_ids 中的所有用户均在应用的通讯录可见范围内
429429000001请求频率超限降低请求频率
500500000004服务内部错误请稍后重试,若持续出现请联系技术支持