教育号->企业微信

部门映射关系

使用场景： 批量根据教育号部门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"
}

教育号->钉钉

部门映射关系

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

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/depart/dingtalk/get_dingtalk_departid?access_token=ACCESS_TOKEN

请求包体：

{
  "depart_ids": [
    30009907,
    30009906
  ]
}

参数说明：

返回结果： 注意只会返回能查询到的映射关系

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "depart_id": 8345924,
      "dingtalk_id": "889970211"
    },
    {
      "depart_id": 8345925,
      "dingtalk_id": "890051041"
    }
  ]
}

参数说明：

用户映射关系

使用场景： 根据教育号userid查询钉钉用户ID

权限说明

请求方式： POST（HTTPS）

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

请求包体：

{
  "userids": [
    "3733218539",
    "3733218551",
    "3733217368"
  ]
}

参数说明：

返回结果： 注意只会返回能查询到的映射关系

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "userid": "3733218539",
      "dingtalk_id": "e_12_3733218539",
      "dingtalk_unionid": "adfasdfadsfas"
    },
    {
      "userid": "3733218551",
      "dingtalk_id": "e_12_3733218183",
      "dingtalk_unionid": "adfasdfadsfas"
    },
    {
      "userid": "3733217368",
      "dingtalk_id": "01094330150526134306",
      "dingtalk_unionid": "adfasdfadsfas"
    }
  ]
}

参数说明：

获取钉钉token

使用场景： 获取机构token中应用和机构对应在钉钉的token

权限说明

请求方式： GET HTTPS）

请求地址： https://oapi.epaas.qq.com/corp/dingtalk/get_dingtalk_token?access_token=ACCESS_TOKEN

请求包体：

{
}

参数说明：

返回结果： 注意只会返回能查询到的映射关系

{
  "errmsg": "ok",
  "errcode": 0,
  "dingtalk_token": "e6d0c051621e372d8dc67730a7e1f2b1",
  "expires_in": 6950,
  "dingtalk_corpid": "ding84430120b09aeadbf5bf40eda33b7ba0",
  "dingtalk_appId": "dinghzohc5bbquspt9ru"
}

参数说明：

钉钉->教育号

部门映射关系

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

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/depart/dingtalk/get_epaas_departid?access_token=ACCESS_TOKEN

请求包体：

{
  "dingtalk_ids": [
    889970211,
    890051041
  ],
  "dingtalk_depart_type": 1
}

参数说明：

返回结果： 注意只会返回能查询到的映射关系

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "dingtalk_id": "889970211",
      "depart_id": 8345924
    },
    {
      "dingtalk_id": "890051041",
      "depart_id": 8345925
    }
  ]
}

参数说明：

用户映射关系

使用场景： 钉钉userid换教育号userid

权限说明

请求方式： POST（HTTPS）

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

请求包体：

{
  "dingtalk_ids": [
    "01094330150526134306"
  ],
  "role_id": 12
}

参数说明：

返回结果： 注意只会返回能查询到的映射关系

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "dingtalk_id": "01094330150526134306",
      "userid": "3733217368"
    }
  ]
}

参数说明：