微信企業號之userid與openid互轉
阿新 • • 發佈:2018-12-05
一.前言
該介面使用場景為微信支付、微信紅包和企業轉賬,企業號使用者在使用微信支付的功能時,需要自行將企業號的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 |