# 人臉業(yè)務(wù)對外API v0.0.4
| 版本 | 變更內(nèi)容 | 作者 | 時間 |
|---|---|---|---|
| 0.0.3 | 首次發(fā)布 | bobymxiang | 2019-11-22 |
| 0.0.4 | info_type枚舉值錯誤，修復(fù)為 ASK_UNIONID | bobymxiang | 2019-12-18 |
URL域名及前綴:
- https://api.mch.weixin.qq.com
# 接口規(guī)范
# 接口列表
# 查詢用戶UnionId
GET /v3/facemch/users/{face_sid}
商戶可以根據(jù)face_sid查詢用戶UnionId。
# 請求參數(shù)
| 變量名 | 所處位置 | 數(shù)據(jù)類型 | 必填 | 限制條件 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| face_sid | path | string | true | 終端設(shè)備識別用戶成功后返回的憑證,getWxpayfaceUserInfo接口返回的token字段 | aabbccdd12345 | |
| info_type | query | string | true | 標(biāo)識本次請求獲取的信息類型 | ASK_UNIONID:獲取用戶union_id | |
| appid | query | string | true | 微信分配的公眾賬號ID | wx2b029c08a6233333 | |
| sub_mchid | query | string | false | 微信支付分配的子商戶號，服務(wù)商模式下必填 | 123456789 | |
| sub_appid | query | string | false | 微信分配的子商戶公眾賬號ID | wx2b029c08a6255555 |
# 返回結(jié)果
| 狀態(tài)碼 | 含義 | 描述 | 數(shù)據(jù)類型 |
|---|---|---|---|
| 200 | OK | 處理成功 | JSON |
應(yīng)答樣例
200 Response
{
"union_id": "abcdefg111"
}