批量查询 sdk用户。
默认接口请求频率限制:20次/秒。
REST URL
POST /api/rest/external/v1/user/sdk/batch/query?enterpriseId=XXX&signature=XXX
请求参数说明
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 | 初始平台 |
enterpriseId | String | Query | 是 | 无 | 企业ID | 5.2-20250926 公有云不存在 |
externalUseIds | List | Body | 否 | 无 | 三方 id,最大 100,与 userProfileIds 二 选一 | 5.2-20250926 公有云不存在 |
userProfileIds | List | Body | 否 | 无 | 小鱼系统用户id,最大 100,与 externalUseIds 二 选一 | 5.2-20250926 公有云不存在 |
请求示例:
{
"externalUseIds":["abcdef","ghi"]
}
返回结果示例:
成功时返回结果数据,失败时返回小鱼RESTAPI错误码
[
{
"externalUserId":"abcdef",
"userProfileId": 123,
"userPhone":"10000:abcdef",
"displayName": "张三",
"expandField":{
"enterpriseUserExpandField1":"组长",
"enterpriseUserExpandField2":"业务部"
}
},
{
"externalUserId":"ghi",
"userProfileId": 124,
"userPhone":"10000:ghi",
"displayName": "张三三",
"expandField":{
"enterpriseUserExpandField1":"组长",
"enterpriseUserExpandField2":"业务部"
}
}
]