Updated on 2022-09-23 GMT+08:00

Overview

DataArts Studio DataArts DataService aims to build a unified data service bus for enterprises to centrally manage internal and external API services. DataArts DataService helps you quickly generate data APIs based on data tables and allows you manage the full lifecycle of APIs, covering API publishing, management, and O&M. With DataArts DataService, you can implement microservice aggregation, frontend-backend separation, and system integration, and provide functions and data for partners and developers easily and quickly at a low cost and risk.

DataArts DataService has the following advantages over other data sharing and exchange methods:
  • Unified interface standards reduce the workload for interconnection with upper-layer applications.
  • Data logic is deployed on the data platform and is therefore decoupled from the application logic. This reduces repeated development of data models and avoids frequent changes caused by data logic adjustment.
  • Data logic-related storage and compute resources are deployed on the data platform, reducing resource consumption on applications.
  • A large amount of detailed and sensitive data is inaccessible to applications. In addition, DataArts DataService improves data security by means of API review and publishing, authentication and throttling, and dynamic anonymization.

DataArts DataService encapsulates data logic into RESTful APIs of a unified standard that can be used to access data. DataArts DataService applies to quick response to the requests for accessing a small amount of data. To open a large amount of data, you are advised to adopt data sharing and exchange or other solutions. .

DataArts DataService uses the serverless architecture. You only need to focus on the API query logic and do not need to worry about the infrastructure such as the operating environment. DataArts DataService prepares compute resources, supports elastic scaling, and spares O&M expenditure.

Figure 1 DataArts DataService architecture

Publishing an API

To publish an API or a group of APIs, do as follows:
  1. Make preparations.

    If you want to use DataArts DataService, you must perform the operations in an Exclusive DataArts DataService instance.

    In addition, before creating an API, you must add a reviewer by following the instructions in Adding Reviewers.

  2. Create an API.

    You can generate and register APIs. An API can be generated in the wizard mode or script mode.

  3. Debug the API.

    Debug the created API on the management console to check whether it runs properly.

  4. Publish the API.

    The API can be called only after it is published.

  5. (Optional) Manage the API.

    You can manage the published API as needed.

  6. (Optional) Perform throttling.

    To ensure the stability of backend services, you can perform throttling on the API.

Calling an API

To call an API, perform the following operations:
  1. Obtain an API.

    Obtain the API from the service catalog. An API can be called only after it is published.

  2. (Optional) Create an application and get authorized.

    For an API that is accessed using application or IAM authentication, you need to create an application and authorize the application to use the API. When you call an API, DataArts DataService verifies your identity based on the key pair (AppKey and AppSecret) of the created application.

  3. Call the API.

    After completing the preceding steps, you can call the API.

Overview Page

On the Overview page, you can view various monitoring data views. The Overview page displays Develop APIs and Call APIs.

Figure 2 Develop APIs tab page
Table 1 Parameters on the Develop APIs tab page

Parameter

Description

APIs Published

The number of APIs published every day, week, month, and year.

APIs Called

The number of times that APIs are called in half a day, every day, every week, and every month.

Top 5 (1)

The call rate of APIs, including the success rate, failure rate, validity rate, and invalidity rate.

Top 5 (2)

The calling duration of APIs, average duration, success duration, and failure duration.

Top 5 (3)

The top 5 APIs that are called, successful API calls, failed API calls, valid API calls, and invalid API calls.

Published

The number of APIs that are published on the API marketplace.

Developing

The number of APIs that are being developed.

Applications

The number of APIs that are requested by applications.

Successful

The number of successful API calls.

Failed

The number of failed API calls.

Total

The total number of API calls.

Figure 3 Call APIs tab page
Table 2 Parameters on the Call APIs tab page

Parameter

Description

APIs Called

The number of API calls made every day, week, month, and year.

Top 5

The ratio of successful and failed API calls in the last seven days.

Completed

The number of APIs applied on the DataArts DataService platform.

Successful

The number of successful API calls on the DataArts DataService platform.

Total

The number of total API calls on the DataArts DataService platform.