云识别接口说明

文档说明

使用接口前需要先到开发者平台进行如下操作：
(1)注册（http://cloud.voidar.net:8080/develop/html/register.jsp）
(2)登录（http://cloud.voidar.net.cn:8080/develop/html/login.jsp）
(3)新建云数据库，取得该数据库的accessKey和apiKey。

1、上传图片

接口说明：上传单张图片到指定的云数据库。
接口地址：http://cloud.voidar.net:8080/develop/ws/uploadTarget.do
请求参数：
.png)

Json数据：
{"name":"10.jpg","metadata":"dGVzdA...","imagedata":"4AAQSkZJRgA..."}
返回结果：
成功：
{
     "code":"0",//返回代码，0表示成功
     "msg":"上传成功",//返回信息
     "image":{//图片详细信息
     "id":3521,//图片ID
     "name":"10.jpg",//名称
     "metadata":"test",//自定义数据
     "rating":5,//识别度评分（1-差 2-较差 3-中 4-较好 5-好）
     "bundle":"0,0,0,0",//是否绑定了assetbundle（ios,android,windows,mac），等于0表示没有绑定，大于0表示已绑定
     "createTime":"2016-03-30 14:11:19"//上传时间
     }
}

2、取得图片列表

接口说明：从云数据库取得指定数量的图片信息。
接口地址：http://cloud.voidar.net:8080/develop/ws/targetList.do
请求参数：
.png)
Json数据：
{"start":0,"num":10}
返回结果：
成功：
{
     "code":"0",//返回代码，0表示成功
     "msg":"",//返回信息
     "total":1,//图片总数
     "data":[{//图片详细信息
     "id":3521,//图片ID
     "name":"10.jpg",//名称
     "metadata":"test",//自定义数据
     "rating":5,//识别度评分（1-差 2-较差 3-中 4-较好 5-好）
     "bundle":"0,0,0,0",//是否绑定了assetbundle（ios,android,windows,mac），等于 0表示没有绑定，大于0表示已绑定
     "createTime":"2016-03-30 14:11:19"//上传时间
     }]
}
失败：
{
     "code":"1",//返回代码，1表示失败
     "msg":"请求数据传输错误"//失败描述
}
演示程序：TargetList.java

3、上传assetbundle

接口说明：上传unity打包的assetbundle文件到云数据库，并与指定图片绑定。
接口地址：http://cloud.voidar.net:8080/develop/ws/uploadBundle.do
请求参数：
.png)
Json数据：
{"id":3521,"platform":1,"bundle":"VW5pdHlXZ..."}
返回结果：
成功：
{
     "code":"0",//返回代码，0表示成功
     "msg":"assetbundle上传成功"//返回信息
}
失败：
{
     "code":"1",//返回代码，1表示失败
     "msg":"请求数据传输错误"//失败描述
}
演示程序：UploadBundle.java

4、取得图片详细信息

接口说明：从云数据库取得指定图片的信息。
接口地址：http://cloud.voidar.net:8080/develop/ws/targetDetail.do
请求参数：
.png)
Json数据：
{"id":3521}
返回结果：
成功：
{
     "code":"0",//返回代码，0表示成功
     "msg":"",//返回信息
     "image":{//图片详细信息
     "id":3521,//图片ID
     "name":"10.jpg",//名称
     "metadata":"test",//自定义数据
     "rating":5,//识别度评分（1-差 2-较差 3-中 4-较好 5-好）
     "bundle":"2,0,0,0",//是否绑定了assetbundle（ios,android,windows,mac），等于 0表示没有绑定，大于0表示已绑定
     "createTime":"2016-03-30 14:11:19"//上传时间
     }
}
失败：
{
     "code":"1",//返回代码，1表示失败
     "msg":"请求数据传输错误"//失败描述
}
演示程序：TargetDetail.java

5、删除图片

接口说明：从云数据库删除指定图片。
接口地址：http://cloud.voidar.net:8080/develop/ws/deleteTarget.do
请求参数：
.png)
Json数据：
{"id":3521}
返回结果：
成功：
{
     "code":"0",//返回代码，0表示成功
     "msg":"删除成功"//返回信息
}
失败：
{
     "code":"1",//返回代码，1表示失败
     "msg":"请求数据传输错误"//失败描述
}
演示程序：DelTarget.java

6、删除assetbundle

接口说明：删除指定图片绑定的assetbundle
接口地址：http:// cloud.voidar.net:8080/develop/ws/deleteBundle.do
请求参数：
.png)
Json数据：
{"id":3521,"platform":1}
返回结果：
成功：
{
     "code":"0",//返回代码，0表示成功
     "msg":"删除assetbundle成功"//返回信息
}
失败：
{
     "code":"1",//返回代码，1表示失败
     "msg":"请求数据传输错误"//失败描述
}
演示程序：DelBundle.java

7、更新自定义数据

接口说明：更新指定图片的metadata
接口地址：http:// cloud.voidar.net:8080/develop/ws/updateMetadata.do
请求参数：
.png)
Json数据：
{"id":3521,"metadata":test}
返回结果：
成功：
{
     "code":"0",//返回代码，0表示成功
     "msg":"更新自定义数据成功"//返回信息
}
失败：
{
     "code":"1",//返回代码，1表示失败
     "msg":"请求数据传输错误"//失败描述
}
演示程序：UpdateMetadata.java

8、code说明

.png)
演示程序使用说明：
安装jdk1.7和eclipse，然后将演示工程导入eclipse(File->Import...->General->Existing Projects into Workspace->Next)，即可运行。