跳转到主要内容
开始创作
开发文档

创建用户

在当前应用所属租户下新建平台用户

在当前应用所属租户下新建平台用户

POST /openapi/v1/users/add

每次调用都会新建用户。手机号字段(phone)采用应用隔离 MD5 哈希存储:计算方式为 md5(trim(手机号) + appId),其中 appId 为本应用的 App ID(格式如 app_94b5813c6bc57289122ee943,可在凭证页查看)。结果为 32 位小写十六进制字符串。同一手机号在不同应用下产生不同哈希,确保应用间数据隔离。

请求参数

参数

类型

请求示例

{
  "nickname": "小明",
  "avatar": "https://example.com/avatar.png",
  "externalId": "your-business-user-id",
  "phone": "0b6f3c8e46e8b249ec5ab0f6c2e0eaf0"
}

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "userId": 10001,
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "externalId": "biz-user-001",
    "nickname": "小明",
    "phone": null,
    "email": null,
    "avatar": "https://example.com/avatar.png",
    "gender": "",
    "birthday": null,
    "age": null,
    "status": 1,
    "isProfileComplete": false,
    "createdAt": "2024-01-01 08:00:00+08",
    "updatedAt": "2024-01-01 08:00:00+08",
    "config": {}
  }
}