插件窝 干货文章 企业微信H5页面如何获取用户身份标识?

企业微信H5页面如何获取用户身份标识?

获取 企业 用户 code 547    来源:    2025-03-15

在企业微信的H5页面中,获取用户身份标识通常需要通过企业微信提供的API接口来实现。以下是获取用户身份标识的步骤:

1. 配置企业微信应用

首先,确保你已经在企业微信管理后台创建了一个应用,并且已经配置好了应用的权限和回调URL。

2. 获取code

企业微信提供了一个OAuth2.0的授权机制,用户访问H5页面时,可以通过以下URL获取code

https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect
  • CORPID: 企业ID,可以在企业微信管理后台找到。
  • REDIRECT_URI: 授权后重定向的回调链接地址,需要经过URL编码。
  • scope: 应用授权作用域,snsapi_base表示静默授权,用户无感知。
  • state: 重定向后会带上state参数,可以填写任意值。

用户访问这个URL后,企业微信会将用户重定向到REDIRECT_URI,并在URL中带上code参数。

3. 使用code获取用户身份标识

获取到code后,你可以通过企业微信的API接口获取用户的身份标识(UserId)。

请求URL:

https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
  • ACCESS_TOKEN: 企业的access_token,可以通过企业微信的API接口获取。
  • CODE: 上一步获取到的code

请求示例:

GET https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE

响应示例:

{
    "errcode": 0,
    "errmsg": "ok",
    "UserId": "USERID",
    "DeviceId": "DEVICEID"
}
  • UserId: 用户在企业微信中的唯一标识。
  • DeviceId: 设备ID,仅在scopesnsapi_privateinfo时返回。

4. 处理用户身份标识

获取到UserId后,你可以根据业务需求进行后续处理,比如查询用户信息、记录用户行为等。

5. 获取access_token

为了调用企业微信的API接口,你需要先获取access_token。可以通过以下URL获取:

https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
  • ID: 企业ID。
  • SECRET: 应用的Secret,可以在企业微信管理后台找到。

请求示例:

GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

响应示例:

{
    "errcode": 0,
    "errmsg": "ok",
    "access_token": "accesstoken000001",
    "expires_in": 7200
}

6. 注意事项

  • code的有效期为5分钟,且只能使用一次。
  • access_token的有效期为2小时,需要定期刷新。
  • 确保REDIRECT_URI与在企业微信管理后台配置的一致,否则会报错。

通过以上步骤,你可以在企业微信的H5页面中获取用户的身份标识,并根据业务需求进行后续处理。