修改目標圖像屬性 | PUT /target/<target_id>

修改 target_id 對應的目標圖像屬性。Http patch 形式修改參數，沒有變化的參數保持不變。

Action

PUT /target/<target_id>

認證

需要

Http Header

Content-Type=application/json

HTTP Header: Authorization (當採用 API Key Token 方式認證)

請求參數

Field	Type	Required	Description
image	String(base64)	Yes	圖像內容的 base64 編碼字符串，支持 JPG 和 PNG 格式圖像。圖片最大 2MB。
active	String	No	"1" 來啓用目標，"0" 來停用目標。默認爲 "1"
name	String	Yes	目標名稱，僅支持英文字母、英文標點、數字，長度最小 1 個字符，最大 64 個字符
size	String（Float）	Yes	識別圖寬度(單位 cm )。識別圖的高度將由系統根據您上傳的圖片自動計算。識別圖的大小和虛擬內容的大小對應。默認 20
meta	String	Yes	一般用於存儲 AR 內容信息，文本字符串格式，默認是""。 例如：識別物的 JSON 信息，圖片的 base64 編碼，或者是大文件在雲存儲的 URL 下載地址。最大 2MB。
type	String (Float)	Yes	必須固定配置爲字符串 "ImageTarget"，注意大小寫需要完全一樣。
allowSimilar	String	No	如果存在相似圖是否強制允許添加，默認 0.相似圖可能影響識別結果，建議採用默認。

附註

• image 限制最大 2MB.
• meta 限制最大 2MB.

請求示例

    PUT /target/e61db301-e80f-4025-b822-9a00eb48d8d2 HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "active":"1",
        "name":"easyar",
        "size":"5",
        "meta":"496fbbabc2b38ecs3460a...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

返回示例

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
          "target": {
            "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
    }

返回字段

字段	描述
statusCode	狀態碼 0 表示認證正確，更多參考 狀態碼
result	錯誤消息，或者目標圖信息
timestamp	響應返回時的服務器端時間。使用 Unix 時間戳格式，以毫秒爲單位
result.targetId	目標圖的唯一 ID
result.trackingImage	跟蹤圖像的 base64 編碼字符串
result.name	目標名稱
result.size	識別圖寬度（單位 cm ）。識別圖的高度將由系統根據您上傳的圖片自動計算。識別圖的大小和疊加虛擬內容的大小對應
result.meta	base64 編碼的附加信息，例如將 json 字符串 base64 編碼後生成的字符串
result.type	固定爲 ImageTarget
result.active	"1" 啓用，"0" 停用

錯誤碼

參見 狀態碼以及錯誤碼大全