人脸支付

最近更新时间:2018-06-13 17:37:25

接口概述

本接口用于人脸支付,支持用户上传一张照片,与库里的照片进行比对,判断是否为同一个人。

url 说明

支持 http 和 https 两种协议:

http://recognition.image.myqcloud.com/face/compare

https://recognition.image.myqcloud.com/face/compare

请求方式

请求头 header

参数名 必选 描述
host recognition.image.myqcloud.com 腾讯云人脸识别服务器域名
content-length 包体总长度 整个请求包体内容的总长度,单位:字节(Byte)
content-type application/json 或 multipart/form-data 根据不同接口选择:
1. 使用 application/json 格式,参数为 url,其值为图片的 url ;
2. 使用 multipart/form-data 格式,参数为 image,其值为图片的二进制内容。
authorization 鉴权签名 多次有效签名,用于鉴权,生成方式见 鉴权签名方法

注意:
选择 multipart/form-data,请使用 http 框架/库推荐的方式设置请求的 content-type,不推荐直接调用 setHeader 等方法设置,否则可能导致 boundary 缺失引起请求失败。

请求参数

使用 application/json 格式,参数选择 url ;使用 multipart/form-data 格式,参数选择 image。

参数名 必选 类型 参数说明
appid string 接入项目的唯一标识,可在 账号信息云 API 密钥 中查看。
imageA binary A 图片内容。
imageB binary B 图片内容。
urlA string A 图片的 url , image 和 url 只需提供一个;如果都提供,只使用 url。
urlB string B 图片的 url , image 和 url 只需提供一个;如果都提供,只使用 url。

返回内容

字段 类型 说明
data.session_id string 相应请求的 session 标识符。
data.similarity float 两个 face 的相似度。
data.fail_flag int 标志失败图片,1 为第一张,2 为第二张(失败时返回)。
code int 返回码。
message string 返回错误消息。

错误码

错误码 含义
3 错误的请求,其中 message:account abnormal,errorno is:2 为账号欠费停服。
4 签名为空。
5 签名串错误。
6 签名中的 appid /存储桶与操作目标不匹配。
9 签名过期。
10 appid 不存在。
11 secretId 不存在。
12 appid 和 secretid 不匹配。
13 重放攻击。
14 签名校验失败。
15 操作太频繁,触发频控。
16 存储桶不存在。
21 无效参数。
23 请求包体过大。
107 鉴权服务不可用。
108 鉴权服务不可用。
213 内部错误。
-1101 人脸检测失败。
-1102 图片解码失败。
-1103 特征处理失败。
-1104 提取轮廓错误。
-1105 提取性别错误。
-1106 提取表情错误。
-1107 提取年龄错误。
-1108 提取姿态错误。
-1109 提取眼镜错误。
-1200 特征存储错误。
-1300 图片为空。
-1301 参数为空。
-1302 个体已存在。
-1303 个体不存在。
-1304 参数过长。
-1305 人脸不存在。
-1306 组不存在。
-1307 组列表不存在。
-1308 url 图片下载失败。
-1309 人脸个数超过限制。
-1310 个体个数超过限制。
-1311 组个数超过限制。
-1312 对个体添加了几乎相同的人脸。
-1400 非法的图片格式。
-1403 图片下载失败。

更多其他 API 错误码请看 错误码说明

示例

使用 url 的请求示例

POST /face/compare HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com
Content-Length: 123
Content-Type: application/json

{
  "appid":"123456",
  "urlA":"http://test-123456.image.myqcloud.com/testA.jpg",
  "urlB":"http://test-123456.image.myqcloud.com/testB.jpg"
}

使用 image 的请求示例

POST /face/compare HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com
Content-Length: 460
Content-Type: multipart/form-data;boundary=--------------acebdf13572468

----------------acebdf13572468
Content-Disposition: form-data; name="appid";

123456
----------------acebdf13572468
Content-Disposition: form-data; name="imageA"; filename="testA.jpg"
Content-Type: image/jpeg

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------acebdf13572468
Content-Disposition: form-data; name="imageB"; filename="testB.jpg"
Content-Type: image/jpeg

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------acebdf13572468--

返回示例

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 109
Content-Type: application/json

{
  "data":{
    "similarity":100.0,
    "session_id":""
  },
  "code":0,
  "message":"OK"
}

如果有其他疑问,您也可以在问答社区中寻求帮助。前往问答社区 >