企业内部开发 客户端API 小程序 企业微信登录接口 code2Session
code2Session

临时登录凭证校验接口是一个服务端HTTPS 接口,开发者服务器使用临时登录凭证code获取 session_key、用户userid以及用户所在企业的corpid等信息。

请求方式:GET(HTTPS)

接口地址:

https://qyapi.weixin.qq.com/cgi-bin/miniprogram/jscode2session?access_token=ACCESS_TOKEN&js_code=CODE&grant_type=authorization_code

请求参数

参数是否必须说明
access_token调用接口凭证(注意,此处的access_token 是企业微信应用的access_token,获取方法参见“获取access_token”。要求必须由该小程序关联的企业微信应用的secret获取
js_code登录时获取的 code
grant_type此处固定为authorization_code

 

权限说明:
access_token必须是与小程序关联的企业微信应用secret所获得。

 

返回说明

//正常返回的JSON数据包
{
      "corpid": "CORPID",
      "userid": "USERID",
      "session_key": "kJtdi6RF+Dv67QkbLlPGjw==",
      "errcode": 0,
      "errmsg": "ok"
}

//错误时返回JSON数据包(示例为Code无效)
{
    "errcode": 40029,
    "errmsg": "invalid code"
}

参数说明

参数说明
corpid用户所属企业的corpid
userid用户在企业内的UserID,对应管理端的帐号,企业内唯一。注意:第三方小程序此处返回加密的userid
session_key会话密钥

注意:

  1. 企业微信的jscode2session请求url与微信的不同
  2. 企业微信的jscode2session返回的是userid,而微信返回的是openid
  3. 获取access_token时请使用企业的corpid参数,请勿使用小程序的appid
  4. 会话密钥 session_key 是对用户数据进行加密签名的密钥,为了应用自身的数据安全,开发者服务器不应该把会话密钥下发到小程序,也不应该对外提供这个密钥。
上一篇
wx.qy.login
下一篇
wx.qy.checkSession