Open API

公共参数

文档中存在的一些公共参数

名称

描述

service

api请求地址前缀

https://gas.graviti.cn/gatewayv2/tensorbay-open-api

your_accesskey

用户申请得到的Accesskey, 可进入GAS开发者中心获取

“Access-xxxxxxx“

HTTP 公共请求头和响应头

公共请求头(Common Request Headers)

名称

类型

描述

Content-Type

string

RFC2616中定义的HTTP请求内容类型。默认值:application/json

X-Token

string

用户申请得到的accesskey

公共响应头(Common Response Headers)

名称

类型

描述

X-Request-Id

string

X-Request-Id是由graviti创建,并唯一标识这个response的UUID。如果在使用graviti服务时遇到问题,可以凭借该内容联系graviti工作人员,快速定位问题。默认值:无

错误码说明

1. 错误码返回格式

当请求发生错误的时候,服务端会返回此类格式的错误信息。

{
"code": "error_code",
"message": "***"
}

【示例】获取数据集时发生404错误:

# 响应状态
HttpStatus 404
# 响应结果
{
"code": "ResourceNotExist",
"message": "dataset not exist!"
}

2. 错误码含义

code

description

AccessDenied

请求被拒绝,缺失权限...

InvalidParamsValue

无效的请求参数,比如参数格式不对,比如造成不幂等

NameConflict

命名冲突

RequestParamsMissing

必传的某个参数缺失

ResourceNotExist

请求资源时,找不到资源

SystemError

系统错误

模糊查询

对于支持模糊查询的api,遵循以下规则

  1. 支持mysql通配符查询,如%, _等通配符

  2. 若无mysql通配符,默认%{模糊查询}%,前后模糊匹配

  3. 若查询字段中含有mysql通配符,自动模糊匹配失效。

  4. 若仅希望通配符当作普通字符串,需要进行转义处理,此时退化为非模糊匹配。若仍需要模糊匹配,需手动构造通配符查询。

【示例】 result: graviti_1, great_graviti_1, graviti%1

  1. name = graviti, 返回结果graviti_1, great_graviti_1, graviti%1

  2. name = graviti\_%, 返回结果graviti_1, great_graviti_1

  3. name = graviti\_, 返回结果无

  4. name = graviti%, 返回graviti_1,graviti%1

  5. name = graviti\%%, 返回graviti%1

  6. name = graviti\%, 返回无

  7. name = graviti\%1, 返回graviti%1

  8. name = %graviti, 返回无

数据集操作函数

api

description

CreateDataset

创建dataset

CreateDraft

创建draft

ListDraft

获取draft列表

updateDataset

更新数据集

CommitDataset

提交dataset

ListDataset

获取dataset列表

DeleteDataset

删除数据集

Dataset操作函数的使用方法详见:

数据操作函数

api

description

GetPolicy

获取数据上传令牌

PutCallback

上传回调

CreateSegment

创建segment

ListSegment

获取segment

DeleteSegment

删除segment

UploadLabelCatalog

更新label catalog

GetLabelCatalog

获取labelca talog

CreateSensor

创建sensor

ListSensor

获取list sensor

DeleteSensor

删除sensor

UploadLabel

更新label

ListLabel

获取数据集的标注标签信息

ListData

获取data

ListDataUri

获取数据的url

DeleteData

删除数据

Data操作函数的使用方法详见: