目标图像管理 API¶

目标图像可以通过一下方式管理：

1）通过WebUI里的“开发者中心”进行管理
2）通过调用Web Service API管理

EasyAR为开发者提供了几个语言的 Target Management Samples，方便程序调用实现自动化:

CRS API 访问接入¶

在您开始管理目标图像之前，您必须先进入开发者中心的CRS创建一个新的CRS APP实例（Cloud Database）

步骤 1) 注册并登录帐户 -> 开发者中心 -> 云识别管理,

步骤 2) 创建新CRS APP实例

步骤 3) 进入管理 -> 查看密钥：

CRS AppId
API Key
API Secret
Cloud URL
- Server-end URL: 用于目标图像管理
- Client-end URL: 为客户端提供图像识别服务

Web Service API¶

CRS API 使用HTTP REST传输标准。API包括两部分参数内容:

公共参数：用于认证
- timestamp
- apiKey
- appId
- signature
应用API特有参数

Notes: 应用API文档描述中不再提及公共参数，实际使用中需要与应用API特有参数一起上传 （接口Ping 除外）

关于更多API如何认证的细节，请参考签名的示例。

API示例: 新增一个目标图像¶

这里看新增一个目标图像的接口输入输出，帮助开发者一窥CRS API的请求参数。

生产版本的app请参考最佳实践来新建一个目标图像。

请求示例

新增一个test-target.jpg的目标图像文件，参考 POST /targets/ ，图像文件base64()编码请求API。

POST /targets HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
    "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
    "active":"1",
    "name":"easyar",
    "size":"5",
    "meta":"496fbbabc2b38ecs3460a...",
    "type":"ImageTarget",
    "timestamp": 1514736000000,
    "apiKey": "8b485c648c3056e79c2a85ee9b51f9dc",
    "appId": "C:CN1:f9f903c36da8bd64d71d491077bbaafd",
    "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json
{
    "statusCode": 0,
    "result": {
        "targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
        "trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."，
        "name": "easyar",
        "size": "5",
        "meta": "496fbbabc2b38ecs3460a...",
        "type": "ImageTarget",
        "modified":1514735000000
        "active":"1"，
        "trackableRate": 0,
        "detectableRate": 0,
        “detectableDistinctiveness”：0,
        "detectableFeatureCount", 0,
        "trackableDistinctiveness", 0,
        "trackableFeatureCount", 0,
        "trackableFeatureDistribution", 0,
        "trackablePatchContrast", 0,
        "trackablePatchAmbiguity", 0
    },
    "timestamp": 1514736000000
}

关于API返回示例的字段定义，请参看响应字段。