Table of Contents

已有相似目标图像 | 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,
    }