Graviti Help Center
  • Graviti Help Center
  • Developer Documentation
    • Developer Tools
      • Graviti Python SDK
      • Graviti CLI
      • Graviti Open API
        • DataSet Operation
        • Data Operation
        • Examples
          • Model training
          • Data mining
  • Product Documentation
    • TensorBay
      • TensorBay: For All Stages of Algorithm Research
      • Quick Start for Developers
      • Quick Start for Team
      • How to Quickly Prepare a Dataset
        • How to Create a New Dataset
        • Manage Data in Cloud Storage
        • Create a Dataset by Filtering
        • Create a Dataset by Merging
        • Quick Use of Open Datasets by Forking
      • Version Control
        • Manage Data Files
        • Manage Annotations
        • Manage Dataset Information
        • Manage Versions
        • Manage Dataset Branches
        • Dataset Activities
        • Dataset Settings
      • Pharos Online Data Visualization
        • Explore Pharos
        • Pharos Visualization Widgets Instruction
      • Collaboration
        • Create a New Team
        • Invite Team Members
        • Team Management
        • Dataset Management
        • View Activity Log
      • How to Integrate TensorBay into Your Pipeline
      • Action
        • Create a Workflow
        • Run Workflows
        • Manage Workflows
        • YAML Syntax Description
        • Crontab syntax Description
        • Automatic Configurations
    • Open Datasets
      • Basic Concepts
      • Search for Datasets
      • Preview Data and Label Distribution Online
      • Use and Manage Datasets Online
      • Download Open Datasets
      • Didn't find the dataset you want?
  • APPs
    • GroundTruth Tools
      • Annotate pictures
    • Sextant
      • Create an Evaluation
      • Custom Metrics
      • Start to Evaluate
      • View Results
  • Release Note
  • Graviti Official Website
Powered by GitBook
On this page
  • Api Overview
  • Actions on Datasets
  • Actions on Data
  • Common
  • Common Parameters
  • Error code description

Was this helpful?

  1. Developer Documentation
  2. Developer Tools

Graviti Open API

Api Overview

Actions on Datasets

API

Description

Acquire the list of authentication configuration

Create a dataset

Delete a dataset

Update a dataset

List datasets

Get a dataset

Create a branch

Delete a branch

List branches

Create a draft

List drafts

Commit a dataset

List commits

Create a tag

Delete a tag

List tags

Upload a dataset note

Get the note of a dataset

Actions on Data

API

Description

Acquire data upload token

Put callback

Batch callback

Create a segment

Delete a segment

List segments

Upload label catalog

Acquire label catalog

Create a sensor

Delete a sensor

List sensors

List data

Acquire data URL

Upload label

Acquire annotation labels of a dataset

Delete data

Common

Common Parameters

Some common parameters in the doc

Name

Descriptions

Value

service

Prefix of API request address

your_accesskey

This module mainly illustrates HTTP common request headers and common response headers.

Name

Type

Descriptions

Content-Type

string

HTTP request content type defined in RFC2616. Default value: application/json

X-Token

string

The AccessKey obtained by the user

Name

Type

Descriptions

X-Request-Id

string

X-Request-Id is created by Graviti and is the only UUID that identifies this response. If you encounter any difficulties when using this service, please contact Graviti. Default value: null

Error code description

Error Code Return Type

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

The server may return any of the following type of errors when your request generates an error. For example, the 404 error code occurs when acquiring a dataset. 。

# Response status
HttpStatus 404
#  Response result
{
    "code": "ResourceNotExist", 
    "message": "dataset not exist!"
}

Error Code

Code

Description

AccessDenied

Request is denied and lack of authorized access.

InvalidParamsValue

Invalid parameter value, e.g., invalid parameter format

NameConflict

Name is conflicted

RequestParamsMissing

The required parameters are missing

ResourceNotExist

The resource does not exist when requested

SystemError

System error

Fuzzy Query

For API that supports fuzzy query, please follow these rules:

  1. Support MySQL wildcard query, such as %, _, and other wildcard characters.

  2. If there is no MySQL wildcard, the default is %{fuzzy query}% with fuzzy matching before and after.

  3. If the query field contains MySQL wildcard, automatic fuzzy matching is disabled.

  4. If you want the wildcard to be treated only as a normal string, you need to transcribe it, and degrade it to non-fuzzy matching. If you still need fuzzy matching, you need to construct the wildcard query manually.

For example: result: graviti_1, great_graviti_1, graviti%1

  1. name = graviti, return graviti_1, great_graviti_1, graviti%1

  2. name = graviti\_%, return graviti_1, great_graviti_1

  3. name = graviti\_, return none

  4. name = graviti%, return graviti_1,graviti%1

  5. name = graviti\%%, return graviti%1

  6. name = graviti\%, return none

  7. name = graviti\%1, return graviti%1

  8. name = %graviti, return none

PreviousDeveloper ToolsNextDataSet Operation

Last updated 3 years ago

Was this helpful?

Get the AccessKey at

ListAuthStorageConfig
CreateDataset
DeleteDataset
updateDataset
ListDataset
GetDataset
CreateBranch
DeleteBranch
ListBranch
CreateDraft
ListDraft
CommitDataset
ListCommit
CreateTag
DeleteTag
ListTag
UploadNote
GetNote
GetPolicy
PutCallback
MultiPutCallback
CreateSegment
DeleteSegment
ListSegment
UploadLabelCatalog
GetLabelCatalog
UploadSensor
DeleteSensor
ListSensor
ListData
ListDataUri
UploadLabel
ListLabel
DeleteData
https://gas.graviti.com/gatewayv2/tensorbay-open-api
GAS Help Center