创建企业成员

username 必填，2–50 字符，允许字母、数字、下划线、中划线、点及中文，企业内唯一。displayName 可选，最长 100 字符。省略 password 由系统生成；显式密码需使用既有 SM2 加密传输，启用审批后禁止机器传入密码。即时创建响应仅返回一次 initialPassword，不应记录日志。

身份验证

MANAGEMENT / PROVISIONING Key；tenant:members:write

Authorization: Bearer <CONTROL_KEY>

审批与重试

启用审批的企业需传 Idempotency-Key，可能返回 HTTP 409 / APPROVAL_REQUIRED，data.operation.executed=false；此时尚未执行，不应当作成功。未启用审批时直接执行；不要假设任意 POST 都支持幂等重试。

审批与重试指南

请求体

usernamestringrequired

2–50 characters; unique within enterprise / 2–50 字符，企业内唯一

displayNamestring

At most 100 characters / 最长 100 字符

passwordstring

SM2 encrypted; omit to generate; forbidden in approval mode / SM2 密文；省略自动生成；审批模式禁止传入

字段使用 camelCase。必填项及可选字段见上文。

JSON

1{
2  "username": "team_app",
3  "displayName": "Team App"
4}

响应

HTTP 201; code: 200. 以下为示例值，字段使用 camelCase。

codeinteger

200

dataobject | null

data.subAccountIdstring

data.usernamestring

data.displayNamestring

data.initialPasswordstring

错误处理

检查 HTTP 状态和 code，失败时读取 serviceCode、msg、traceId。无效凭证无法读取数据；缺少 scope 返回 API_KEY_SCOPE_DENIED。跨企业资源不可访问。不要把 202 接受或审批待处理当作业务完成。