教育号->企业微信

部门映射关系

使用场景： 批量根据教育号部门ID（department_id）查询对应的企业微信ID。

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/department/qywechat/get_qywechat_ids?access_token=ACCESS_TOKEN

请求包体：

{
    "department_ids": [
        30009907,
        30009906
    ]
}

参数说明：

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "qywechat_ids": [
        {
            "department_id": 30009907,
            "qywechat_id": "xxxx"
        }
    ]
}

参数说明：

用户映射关系

使用场景： 根据userid查询用户企业微信ID。

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/user/qywechat/get_qywechat_ids?access_token=ACCESS_TOKEN

请求包体：

{
    "userids": [
        30009907,
        30009906
    ]
}

参数说明：

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "qywechat_ids": [
        {
            "userid": 30009907,
            "qywechat_id": "xxxx"
        }
    ]
}

参数说明：

企业微信->教育号

部门映射关系

使用场景： 批量根据企业微信ID查询对应的教育号部门ID。

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/department/qywechat/get_department_ids?access_token=ACCESS_TOKEN

请求包体：

{
  "qywechat_ids": [
    30009907,
    30009906
  ],
  "qywechat_department_type": 1
}

参数说明： 机构ID和部门ID一致时，表示企业微信部门映射到机构

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "department_infos": [
    {
      "qywechat_id": 30009907,
      "departments": [
        {
          "department_id": 40009907,
          "corpid": 40009907,
          "qywechat_department_type": 1
        }
      ]
    }
  ]
}

参数说明：

用户映射关系

使用场景： 企业微信userid换教育号userid

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/user/qywechat/get_user_ids?access_token=ACCESS_TOKEN

请求包体：

{
  "qywechat_ids":[
    "SC_phone_1d21934867211600",
    "SC_1d2195ecca211600",
    "SC_phone_1d21963fcb211600",
    "isNotExistQyWeChatId"
  ]
}

参数说明：

返回结果：

注意：如果查询的企业微信用户ID不存在，则对应返回的 userInfos 为空数组

{
  "errmsg": "ok",
  "errcode": 0,
  "usersInfos": [
    {
      "qywechat_id": "SC_1d2195ecca211600",
      "userInfos": [
        {
          "corpid": 100001,
          "userid": "30048601",
          "role_id": 11
        }
      ]
    },
    {
      "qywechat_id": "SC_phone_1d21934867211600",
      "userInfos": [
        {
            "corpid": 100002,
          "userid": "30048600",
          "role_id": 12
        }
      ]
    },
    {
      "qywechat_id": "SC_phone_1d21963fcb211600",
      "userInfos": [
        {
          "corpid": 100003,
          "userid": "30048602",
          "role_id": 13
        }
      ]
    },
    {
      "qywechat_id": "isNotExistQyWeChatId",
      "userInfos": []
    }
  ]
}

参数说明：

机构映射关系

使用场景： 获取企业微信明文corpid

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/user/qywechat/get_qywx_corpid?access_token=ACCESS_TOKEN

请求参数：

返回参数：

返回示例：

{
  "errmsg": "ok",
  "errcode": 0,
  "qywx_corpid": "corpid"
}