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,
    }