# 人脸业务对外API v0.0.4
| 版本 | 变更内容 | 作者 | 时间 |
|---|---|---|---|
| 0.0.3 | 首次发布 | bobymxiang | 2019-11-22 |
| 0.0.4 | info_type枚举值错误，修复为 ASK_UNIONID | bobymxiang | 2019-12-18 |
URL域名及前缀:
- https://api.mch.weixin.qq.com
# 接口规范
# 接口列表
# 查询用户UnionId
GET /v3/facemch/users/{face_sid}
商户可以根据face_sid查询用户UnionId。
# 请求参数
| 变量名 | 所处位置 | 数据类型 | 必填 | 限制条件 | 描述 | 示例 |
|---|---|---|---|---|---|---|
| face_sid | path | string | true | 终端设备识别用户成功后返回的凭证,getWxpayfaceUserInfo接口返回的token字段 | aabbccdd12345 | |
| info_type | query | string | true | 标识本次请求获取的信息类型 | ASK_UNIONID:获取用户union_id | |
| appid | query | string | true | 微信分配的公众账号ID | wx2b029c08a6233333 | |
| sub_mchid | query | string | false | 微信支付分配的子商户号，服务商模式下必填 | 123456789 | |
| sub_appid | query | string | false | 微信分配的子商户公众账号ID | wx2b029c08a6255555 |
# 返回结果
| 状态码 | 含义 | 描述 | 数据类型 |
|---|---|---|---|
| 200 | OK | 处理成功 | JSON |
应答样例
200 Response
{
"union_id": "abcdefg111"
}