最新更新時間：2022.08.24 版本說明
通過此API，商圈商戶/服務(wù)商可自行查詢用戶的商圈會員積分服務(wù)授權(quán)狀態(tài)。
適用對象： 服務(wù)商
請求URL：https://api.mch.weixin.qq.com/v3/businesscircle/user-authorizations/{openid}
請求方式：GET
接口頻率：150QPS
前置條件：商圈服務(wù)商已開通支付即積分產(chǎn)品功能
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商圈商戶ID | sub_mchid | string[1, 64] | 否 | query當以服務(wù)商模式管理商圈積分能力時，則要帶上商圈商戶ID，否則留空 示例值：1234567890 |
| 小程序appid | appid | string[1, 128] | 是 | query顧客授權(quán)積分時使用的小程序的appid 示例值：wx1234567890abcdef |
| 顧客openid | openid | string[1, 64] | 是 | path顧客授權(quán)時使用的小程序上的openid 示例值：oWmnN4xxxxxxxxxxe92NHIGf1xd8 |
https://api.mch.weixin.qq.com/v3/businesscircle/user-authorizations/oWmnN4xxxxxxxxxxe92NHIGf1xd8?sub_mchid=1234567890&appid=wx1234567890abcdef
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 顧客openid | openid | string[1, 64] | 是 | 顧客授權(quán)時使用的小程序上的openid 示例值：oWmnN4xxxxxxxxxxe92NHIGf1xd8 |
| 授權(quán)狀態(tài) | authorize_state | string[1, 32] | 是 | 顧客授權(quán)商圈積分結(jié)果 UNAUTHORIZED：未授權(quán) AUTHORIZED：已授權(quán) DEAUTHORIZED：已取消授權(quán) 示例值：UNAUTHORIZED |
| 授權(quán)時間 | authorize_time | string[1, 32] | 否 | 顧客成功授權(quán)商圈積分的時間,遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒毫秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領(lǐng)先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示北京時間2015年05月20日13點29分35秒（需要增加所有跟時間有關(guān)的參數(shù)的描述） 示例值：2020-05-20T13:29:35+08:00 |
| 取消授權(quán)時間 | deauthorize_time | string[1, 32] | 否 | 顧客關(guān)閉授權(quán)商圈積分的時間,遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒毫秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領(lǐng)先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示北京時間2015年05月20日13點29分35秒（需要增加所有跟時間有關(guān)的參數(shù)的描述） 示例值：2020-05-20T13:29:35+08:00 |
{
"openid": "oWmnN4xxxxxxxxxxe92NHIGf1xd8",
"authorize_state": "AUTHORIZED",
"authorize_time": "2020-05-20T13:29:35+08:00"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 請求參數(shù)中Appid非商圈支付即積分配置的Appid | 請確保Appid為支付即積分配置的Appid |
| 400 | PARAM_ERROR | 請求參數(shù)中Appid和Openid不匹配 | 請使用Appid匹配的Openid調(diào)用 |
| 400 | PARAM_ERROR | 請求參數(shù)中Appid無效 | 請使用正確的Appid調(diào)用 |
| 400 | PARAM_ERROR | 請求參數(shù)中Openid無效 | 請使用正確的Openid調(diào)用 |
| 400 | INVALID_REQUEST | 當前請求服務(wù)商非商圈支付即積分服務(wù)商 | 請以商圈支付即積分功能的服務(wù)商身份調(diào)用 |