创建或更新 sdk 用户
默认接口请求频率限制:20次/秒。
REST URL
POST /api/rest/external/v1/user/sdk/createOrUpdate?enterpriseId=XXX&externalUserId=XXX
请求参数说明
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 | 初始平台 |
enterpriseId | String | Query | 是 | 无 | 企业ID | 5.2-20250926 公有云不存在 |
externalUserId | String | Query | 否 | 无 | 三方账号,不存在则创建新用户 | 5.2-20250926 公有云不存在 |
displayName | String | Body | 否 | 无 | 姓名 | 5.2-20250926 公有云不存在 |
expandField | Json,结构见示例 | Body | 否 | 无 | 扩展属性,自定义标签内容。查询自定义标签 | 5.2-20250926 公有云不存在 |
请求示例:
{
"displayName": "张三",
"expandField":{
"enterpriseUserExpandField1":"组长",
"enterpriseUserExpandField2":"业务部"
}
}
返回结果示例:
成功时返回结果数据,失败时返回小鱼RESTAPI错误码
{
"externalUserId":"abcdef",
"userProfileId": 123,
"userPhone":"10000:abcdef",
"displayName": "张三",
"expandField":{
"enterpriseUserExpandField1":"组长",
"enterpriseUserExpandField2":"业务部"
}
}