已有相似目标图像 | POST /similar
在图库中检查是否已有与目标图像类似的图像。推荐在创建一个新目标前使用此接口。
Action
POST /similar
认证
需要
Http Header
Content-Type=application/json
HTTP Header: Authorization (当采用 API Key Token 方式认证)
请求参数
| Field | Type | Required | Description |
|---|---|---|---|
| image | String(base64) | Yes | 图像内容的 base64 编码字符串,支持 JPG 和 PNG 格式图像。 |
返回字段
| 字段 | 描述 | |
|---|---|---|
| statusCode | 状态码 0 表示认证正确,更多参考 状态码 | |
| result | 错误信息,或者结果:多个相似目标图的数组,如果 result 是空数组的说明不存在相似图 | |
| timestamp | 响应返回时的服务器端时间。使用 Unix 时间戳格式,以毫秒为单位 |
错误码
参见 状态码以及错误码大全
请求示例
POST /similar/ HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
"image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
"timestamp": 1514736000000,
"appKey": "test_app_key",
"signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
}
返回示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"statusCode": 0,
"result": {
"date": "2016-06-15T09:58:51.000Z",
"results":[
{
"targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
"trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
"name": "easyar",
"size": "5",
"meta": "496fbbabc2b38ecs3460a...",
"type": "ImageTarget",
"date": "2016-06-15T09:56:30.000Z",
"active":"1",
"trackableRate": 0,
"detectableRate": 0,
"detectableDistinctiveness":0,
"detectableFeatureCount": 0,
"trackableDistinctiveness": 0,
"trackableFeatureCount": 0,
"trackableFeatureDistribution": 0,
"trackablePatchContrast": 0,
"trackablePatchAmbiguity": 0
}
]
},
"timestamp": 1514736000000,
}