第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
身份验证
网页授权登录
构造网页授权链接
构造网页授权链接
最后更新:2023/12/27

目录

  • 构造第三方应用oauth2链接
  • 构造企业oauth2链接
  • scope的特殊情况
  • 构造第三方应用oauth2链接

    如果第三方应用需要在打开的网页里面携带用户的身份信息,第一步需要构造如下的链接来获取code:

    https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

    参数说明:

    参数必须说明
    appid第三方应用id(即ww或wx开头的suite_id)。注意与企业的网页授权登录不同
    redirect_uri授权后重定向的回调链接地址,请使用urlencode对链接进行处理 ,注意域名需要设置为第三方应用的可信域名
    response_type返回类型,此时固定为:code
    scope应用授权作用域。
    snsapi_base:静默授权,可获取成员的基础信息(UserId与DeviceId);

    snsapi_privateinfo:手动授权,可获取成员的详细信息,包含头像、二维码等敏感信息。
    state重定向后会带上state参数,企业可以填写a-zA-Z0-9的参数值,长度不可超过128个字节
    #wechat_redirect固定内容

    企业员工点击后,页面将跳转至 redirect_uri?code=CODE&state=STATE,第三方应用可根据code参数获得企业员工的corpid与userid。code长度最大为512字节。

    权限说明:
    使用snsapi_privateinfo的scope时,第三方应用必须有“成员敏感信息授权”的权限。

    构造企业oauth2链接

    对于旧的套件应用,只能为每个授权企业构造不同的oauth2链接,以获取code参数:

    https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&agentid=AGENTID&state=STATE#wechat_redirect

    参数说明:

    参数必须说明
    appid企业的CorpID
    redirect_uri授权后重定向的回调链接地址,
    请使用urlencode对链接进行处理。
    redirect_uri的域名必须与该应用的可信域名一致
    response_type返回类型,此时固定为:code
    scope应用授权作用域。
    snsapi_base:静默授权,可获取成员的的基础信息(UserId与DeviceId);
    snsapi_privateinfo:手动授权,可获取成员的详细信息,包含头像、二维码等敏感信息
    agentid企业应用的id建议填上该参数(对于第三方应用和代开发自建应用,在填写该参数的情况下或者在工作台、聊天工具栏、应用会话内发起oauth2请求的场景中,会触发接口许可的自动激活)
    state重定向后会带上state参数,企业可以填写a-zA-Z0-9的参数值,长度不可超过128个字节
    #wechat_redirect终端使用此参数判断是否需要带上身份信息

    员工点击后,页面将跳转至 redirect_uri?code=CODE&state=STATE,企业可根据code参数获得员工的userid。code长度最大为512字节。

    scope的特殊情况

    • 第三方服务商配置scope为snsapi_privateinfo时,agentid所对应的应用必须有“成员敏感信息授权”的权限。“成员敏感信息授权”的开启方法为:登录服务商管理后台->标准应用服务->本地应用->进入应用->点击基本信息栏“编辑”按钮->勾选"成员敏感信息"
    上一篇开始开发
    下一篇获取访问用户身份
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    小程序接入对外收款
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们