1)请求地址
https://v.1dq.com/api/v9/searchface
2)示范URL
https://v.1dq.com/api/v9/searchface?key=您的key&faceset_name=&key_face_id=&count=
3)请求参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
key |
string |
Y |
AppKey在我的数据页面 |
xxxxxx |
- |
faceset_name |
string |
Y |
要搜索的组的名称 |
|
- |
key_face_id |
string |
Y |
要搜索的人脸ID,添加人脸后返回 |
|
- |
count |
string |
N |
返回数量,默认10 |
|
- |
4)选填参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
trans_id |
string |
N |
用户订单号,24 字符以内 |
2017201230 |
- |
trans_date |
string |
N |
用户订单时间,格式为YYmmddHHiiss |
20160112122233 |
- |
trans_remark |
string |
N |
用户备注,原路返回 |
xxx |
- |
account |
string |
N |
是否返回账户信息 ,如需返回剩余可用次数,请传递auto如果账户是按次数扣除,则返回剩余次数如账户是按金额扣除,则返回账户剩余金额
|
auto |
- |
output |
string |
N |
输出格式,默认JSON;可选项JSON/XML |
JSON |
- |
5)返回参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
error_code |
int |
Y |
状态码 |
- |
- |
reason |
string |
Y |
状态说明 |
- |
- |
ordersign |
string |
Y |
订单号 |
- |
- |
result |
string |
Y |
结果集 |
- |
- |
----face_id |
string |
- |
人脸的ID |
- |
- |
----tag |
string |
- |
人脸的标识符 |
- |
- |
----similarity |
string |
- |
相似度 |
- |
- |
6)返回JSON结果示例
{
"error_code": 0,
"reason": "请求成功",
"result": {
"candidate": [
{
"face_id": "958ea895a29bbaffd6c14fde39c11eb4",
"similarity": 99.9909,
"tag": "你的标识"
}
]
}
}