根据企业微信ID获取全时用户ID

根据企业微信ID获取全时用户ID

1. 接口描述

接口名称:

/confopenapi/wechat/convertWeChatIdToUmsId

发送方式:

POST

参数格式:

accept: application/json;content-type: application/json

2. 输入参数

Http Header

参数名 必选 类型 说明
token 是 接口调用鉴权参数 也可以放在http body中

Http Body

参数名 必选 类型 说明
thirdUserIds 是 Array string 数组 企业微信ID数组
corpId 是 string 企业微信corpId
suiteId 是 string 企业微信插件ID

3. 示例

传参示例

{
    "thirdUserIds": ["00775184"],
    "corpId":"wp3cf0CQA6LWfKZQqSj9hM9w",
    "suiteId":"dk79d4f863d2",
}

返回示例

{
    "status": 0,
    "result": [
        {
            "umsUserId": 24433900,
            "plainUserId": "00775184",
            "cipherUserId": "wo3cf0CQAAAk93TmyDiBFyFSDQfVDg7A"
        }
    ],
    "msg": "Conver wechat ids Success",
    "request_id": "confopenapiserver-10.70.45.126-1717051240.374883829.332",
    "timestamp": 1717051240374,
    "request_duration": "368.664478ms"
}

4. 返回参数

参数名 类型 说明
status int 0:成功,非0失败
result Array 用户信息数组
msg string 消息

result 单个对象说明

参数名 类型 说明
umsUserId int 全时用户ID
plainUserId int 企业微信明文用户ID
cipherUserId int 企业微信密文用户ID

备注

  • 更多返回错误代码请看首页的错误代码描述