Help Center/ DataArts Studio/ User Guide/ DataArts DataService/ Calling APIs in DataArts DataService/ Applying for API Authorization
Updated on 2026-01-28 GMT+08:00
View PDF
Share

Applying for API Authorization

If you are an API developer and want to call an API which uses app or IAM authentication, you must apply for API authorization.

If you have authorized apps to use the API by following the instructions in Authorizing an API Which Uses App Authentication to Apps, Authorizing an API Which Uses IAM Authentication to Apps, or Authorizing an API Which Uses IAM Authentication Through a Whitelist, skip this section.

Notes and Constraints

  • In DataArts DataService Exclusive, APIs which use IAM authentication must be authorized through apps or whitelists so that they can be called.
  • You can only authorize an API through an app rather than a whitelist.
  • APIs using the app authentication can be authorized only to apps of the APP type.
  • APIs using the IAM authentication can be authorized only to apps of the IAM type.

Authorizing an API to Apps

If an API is accessed using APP or IAM authentication, the API can be called only after being authorized. Authorization can be performed by an API developer or an API caller. This section uses the latter as an example.

  1. On the DataArts Studio console, locate a workspace and click DataArts DataService.
  1. In the left navigation pane, choose an edition, for example, Exclusive Edition. The Overview page is displayed.
  2. Choose API Calling > Service Catalogs to view all the published APIs.
  3. Click the name of the API you want to bind to an app.
  4. On the page displayed, click Permission Application.
  5. On the displayed page, set the expiration time, select an app, and click OK.

    If Parameter Location was set to Static for an input parameter during API creation, you must also set a static parameter value. If no value is set for the static parameter, the default value of the API input parameter will be used when the API is called using an SDK, and an error will be reported indicating that the static parameter value is missing when the API is called using a tool.

    Figure 1 Applying for permissions

  6. After the application is approved by the review center, the authorization is successful.
  7. After the authorization is complete, view the bound APIs on the app details page.
    • If the list of bound APIs contains APIs that do not need to be bound, click Unbind in the Operation column of the API to delete the APIs that do not need to be bound. After the application is approved, the APIs are unbound successfully.
    • To test an API to which the app is bound, choose More > Debug in the Operation column.
    • If you want to extend the authorization period of the bound API, click Renew. After the application is approved by the review center, the renewal is successful.