说明 SaaS 子用户的查询、创建与禁用能力，适用于 SaaS 嵌入方案的运营与账户管理场景。
所有接口均使用 Bearer Token 进行认证。
请求 Header 示例：
Authorization: Bearer Yoo-AI.xxxx.xxxxxx
Content-Type: application/json| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 在 SaaS 应用配置中获取的 Bearer Token |
Content-Type | string | 是 | 固定为 application/json |
POSThttps://saas.api.yoo-ai.com/saas/user/list响应示例：
{
"code": 200,
"msg": "成功",
"data": [
{
"nickname": "测试用户",
"mobile": "18688559044",
"uid": "87hhhrio9",
"union_id": "QAXTSb6TaW",
"created_at": "2025-07-05 16:46:00"
}
],
"request_id": "YOO-saas-api686b77008d63b"
}POSThttps://saas.api.yoo-ai.com/saas/user/create请求参数：
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
uid | string | 是 | 用户唯一标识，最大长度 32 |
nickname | string | 是 | 用户昵称，最大长度 16 |
mobile | string | 是 | 用户手机号 |
成功响应示例：
{
"code": 200,
"msg": "创建成功",
"data": {
"union_id": "YK6tR4mpp5",
"uid": "10086"
},
"request_id": "YOO-saas-api689318b54e796"
}用户已存在响应示例：
{
"code": 2008,
"msg": "用户已存在...",
"data": {},
"request_id": "YOO-saas-api68931ade2410d"
}POSThttps://saas.api.yoo-ai.com/saas/user/ban请求参数：
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
union_id | string | 是 | 用户创建时返回的 union_id |
响应示例：
{
"code": 200,
"msg": "处理成功",
"data": [],
"request_id": "YOO-saas-api686b76ba45139"
}uid 保持稳定映射union_id，用于后续禁用和用户关联| 错误码 | 描述 | 建议处理方式 |
|---|---|---|
2008 | 用户已存在 | 更换 uid 或查询现有用户 |
1815 | 未授权或 Token 错误 | 检查 Authorization Header |
500 | 服务内部错误 | 保留请求日志并联系技术支持 |