全部產品
Search
文件中心

Dataphin:管理API許可權

更新時間:Nov 19, 2025

您需要申請API許可權後,才能調用API。本文為您介紹如何申請和交還API許可權。

前提條件

已購買資料服務增值服務並且當前租戶已開通資料服務模組。如需開通,請參見租戶管理

許可權說明

僅應用負責人支援回收API許可權。

申請API許可權

  1. 在Dataphin首頁的頂部功能表列,選擇管理中心 > 許可權管理

  2. 在左側導覽列選擇我的許可權 > 資料服務許可權,再單擊頂部功能表列的API許可權,在API許可權頁簽,單擊右上方的+申請API許可權按鈕。

  3. API許可權申請頁面,配置參數。

    參數

    描述

    API權限物件

    API

    根據服務專案與API分組選擇API。若為個人帳號申請API許可權,需選擇當前操作人已加入的服務專案,避免許可權無法申請。

    帳號類型

    選擇為API授權的帳號類型,支援選擇應用個人帳號。系統預設選中應用

    • 應用:當API為Create、Update、Delete操作類型時,僅可授權應用。

    • 個人帳號:當帳號類型為個人帳號,API選擇開發環境且為Basic模式,訪問的資料環境為生產資料環境,請謹慎操作;若API選擇開發環境且為Dev-Prod模式,訪問的資料環境為開發資料環境。

    API運行環境

    當帳號類型為應用時需配置。選擇API的運行環境,支援開發環境生產環境,可多選。

    說明

    API的運行根據所選的運行環境進行運行。當API運行環境選擇開發環境時,API基於提交至開發環境的配置運行;當API運行環境選擇生產環境時,API基於發布至生產環境的配置運行。

    許可權所屬專案

    根據API所選擇的服務專案展示,不支援修改。

    應用

    當帳號類型選擇應用時需配置。根據應用分組選擇應用,支援選擇當前操作人已加入的應用。

    許可權欄位表

    當帳號類型選擇應用時需配置。可選欄位將根據API運行環境選擇生產環境或開發環境下需授權的欄位。若API關聯了行級許可權,系統會以行級許可權生效中進行標識,您可以單擊查看行級許可權按鈕,在查看行級許可權面板中,切換查看對應環境的行級許可權資訊。

    說明
    • 當API選擇開發環境且為Basic模式,訪問的資料環境為生產資料環境,請謹慎操作。

    • 當API運行環境為生產環境時,可選擇當前API線上版本的返回參數;當API運行環境為開發環境時,可選擇當前API最新版本開發環境下的返回參數。

    • 當應用申請代理模式許可權調用API時,系統會根據被代理使用者的行級許可權返回資料範圍;若應用沒有代理模式許可權,則根據應用的行級許可權返回資料。

    • 當API為Create、Update、Delete操作類型時,根據API的運行環境訪問資料,無需選擇欄位。

    許可權配置

    權限類別型

    系統預設選中使用許可權,不支援修改;當帳號類型選擇應用時,支援選擇代理許可權

    • 使用許可權:當API為Create、Update、Delete操作類型時,僅支援申請使用許可權。

    • 代理許可權:當API開啟了行級許可權且配置的DelegationUid參數非空(即在資料服務 > 調用 > 已授權API服務的調用頁面的公用參數列表地區配置行級許可權參數值)時生效。在調用API時,需申請代理模式許可權,應用才能代理使用者調用關聯了行級許可權的API,更多API調用的直連模式和代理模式說明,請參見API調用/測試直連模式和代理模式說明

    有效期間

    系統支援選擇30天90天180天長期,您也可以選中自訂後,選擇到期日。

    申請原因

    填寫申請原因,便於審批者查看審批原因。不超過128個字元。

  4. 單擊提交,完成API許可權申請。

交還API許可權

  1. API許可權頁簽,單擊目標API操作列下的交還

  2. 是否進行交還該許可權對話方塊中,單擊確定,完成API許可權的交還。