根据企业微信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

备注

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