本文主要是介绍微信企业号之userid与openid互转,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
一.前言
该接口使用场景为微信支付、微信红包和企业转账,企业号用户在使用微信支付的功能时,需要自行将企业号的userid转成openid。在使用微信红包功能时,需要将应用id和userid转成appid和openid才能使用。
二.userid转换为openid
请求说明
Https请求方式: POST
https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_openid?access_token=ACCESS_TOKEN
1.请求参数
{"userid": "zhangsan","agentid": 1
}
2.参数说明
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
userid | 是 | 企业号内的成员id |
agentid | 否 | 整型,需要发送红包的应用ID,若只是使用微信支付和企业转账,则无需该参数 |
3.权限说明
成员必须处于应用的可见范围内,并且管理组对应用有使用权限、对成员有查看权限。
4.返回说明
{"errcode": 0,"errmsg": "ok","openid": "oDOGms-6yCnGrRovBj2yHij5JL6E","appid":"wxf874e15f78cc84a7"
}
5.返回参数说明
参数 | 说明 |
---|---|
openid | 企业号成员userid对应的openid,若有传参agentid,则是针对该agentid的openid。否则是针对企业号corpid的openid |
appid | 应用的appid,若请求包中不包含agentid则不返回appid。该appid在使用微信红包时会用到 |
三.openid转为userid
该接口主要应用于使用微信支付、微信红包和企业转账之后的结果查询,开发者需要知道某个结果事件的openid对应企业号内成员的信息时,可以通过调用该接口进行转换查询。
1.请求说明
Https请求方式: POST
https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_userid?access_token=ACCESS_TOKEN
2.请求参数
{"openid": "oDOGms-6yCnGrRovBj2yHij5JL6E"
}
3.参数说明
参数 | 必须 | 说明 |
---|---|---|
openid | 是 | 在使用微信支付、微信红包和企业转账之后,返回结果的openid |
4.权限说明
管理组需对openid对应的企业号成员有查看权限。
5.返回说明
{"errcode": 0,"errmsg": "ok","userid": "zhangsan"
}
6.返回参数说明
参数 | 说明 |
---|---|
userid | 该openid在企业号中对应的成员userid |
这篇关于微信企业号之userid与openid互转的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!