綁定API至應用

1.1 版本

1.2 應用場景

1）使用者希望能對多個 API 進行分組管控，在相同分組中，能統一設定認證方式、存取頻率、授權有效期。

2）維運 API 時，能透過分組維度，查看該分組下 API 資訊、呼叫記錄。

1.3 功能簡介

1）FineDataLink 支援在建立 API 時和建立後綁定其至對應的應用中，可在應用中為多個 API 統一設定認證方式、存取頻率、授權有效期。如下圖所示：

設定認證方式可保證發佈的 API API在被外部系統呼叫時更安全。

2）多個 API 綁定相同應用，相當於讓多個 API 擁有了被存取的統一父路徑。

資料服務發佈的 API 存取地址為：FDL伺服器地址+/service/publish/應用ID+APIPath

API 地址範例：https://demo.finedatalink.com/service/publish/673d189b-ce05-4029-912a-2e68a72da6c3/wendang

應用ID	APIPath
每個應用有唯一的 ID（AppId，用於唯一標識應用）和認證資訊（AppCode 認證碼） 4.2.6.2 及之後版本，支援修改應用路徑

3）應用與 API 是多對多的對應關係，同一個 API 可以存在於多個應用中；同一個應用中也可以有多個 API。

4）API 的上下線狀態與綁定狀態互不影響，如果應用綁定了一個下線的 API，呼叫該 API 時，會提示 API 未上線。

1）由於當前發佈 API 的 Token-APPCode 是直接在請求中傳遞的，為增強安全性，建議使用者使用 HTTPS 部署 FineDataLink。

非超級管理者使用者想要使用該功能需要為使用者分配 数据服务API管理权限、資料服務應用管理權限

2）資料服務發佈的 API 若想被呼叫成功，必須綁定應用。綁定應用方式：

• 方式一：參考本文內容，建立應用/修改應用，綁定已設定好的 API 。

• 方式二：資料服務中建立 API 時，在 API資訊 步驟中，綁定已有應用。
  

3.1 建立應用

點選「資料服務>應用列表」，在有權限的資料夾中建立應用。如下圖所示：

應用名稱：必填，預設為空 。

應用描述：定義應用的詳細描述，可為空 。

3.2 設定應用

可設定應用路徑、應用認證方式、綁定API 。如下圖所示：

3.2.1 應用路徑

4.2.6.2 之前版本：

建立應用時，提示應用ID將在應用儲存後自動生成；修改應用時，可以查看當前生效的應用ID 。

4.2.6.2 及之後版本：

3.2.2 應用認證方式

支援三種認證方式：無認證、AppCode、摘要籤名。

注：若在應用中設定了應用認證方式 ，則應用下的所有 API 都需要使用該鑑權方式。

無認證：

呼叫 API 時不需要傳入認證資訊。

AppCode：

1）選擇 AppCode 認證方式後，將展示 AppCode 值。

2）支援點選「重置」按鈕重置 AppCode，點選「重置」按鈕後，將自動檢查當前使用者是否有權管理應用下所有的 API ，如果無權限則報錯提示存在已綁定但是無權限的 API，需要有應用下所有 API 的權限才能重置 AppCode。

權限檢查成功後，提示 AppCode 將在應用儲存後重新生成，儲存後生效，編輯頁面未儲存則不做重置。

3）呼叫 API 時：

需要在請求頭中指定 Authorization 請求頭的值為：AppCode + 空格 + APPCode值。

AppCode 值範例：AppCode 35f3c79e-08e2-4f6f-8eed-60f40f5ca4db

範例參考：

使用数据服务发布的API（POST application/json请求）

使用数据服务发布的API（GET 请求）

使用数据服务发布的API（POST x-www-form-urlencoded请求）

数据服务简单示例

摘要簽章：

當應用認證配置為「摘要簽章」時，下方會顯示 AppSecret ，摘要簽章認證方式說明詳情參見：摘要簽章認證方式

3.2.3 綁定 API

使用者只能查看、綁定、管理自己有權限的 API。

資料服務發佈的 API 若想呼叫成功，必須綁定應用。

應用與 API 是多對多的對應關係，同一個 API 可以存在於多個應用中；同一個應用中也可以有多個 API。

單個 API 修改授權有效期/存取頻率、解綁：

批量修改授權有效期/存取頻率、批量解綁：

勾選已綁定的 API，點選「批量設定」，可以對 API 的認證方式授權有效期進行設定，同時可設定 API 被存取的頻率，如下圖所示：

3.3 查看應用

應用設定完成儲存後，可以查看到當前應用的認證方式是否啟動、認證、應用ID、已經綁定的 API 等資訊。如下圖所示：

基本資訊說明：

3.4 特殊情況說明

應用列表中僅展示當前使用者有管理權限的資料夾、應用。

1）應用可在資料夾中進行管理。如下圖所示：

2）可對應用做重新命名、行動、刪除操作。如下圖所示：

當應用綁定着當前使用者無管理權限的 API ，即使有應用管理權限，也不允許刪除應用，刪除時提示告知無法刪除。

當應用綁定的 API 當前使用者都有管理權限，且使用者有應用管理權限，允許其刪除應用。

3）支援編輯應用。如下圖所示：

進入應用編輯頁面，點選左上角「編輯」按鈕可修改應用的名稱和描述。如下圖所示：

4.1.6.4 及之後版本，支援匯出 API 文檔。

5.1 應用場景

API 開發完成後，需要將 API 說明文檔提供給呼叫者，供呼叫者查看。

5.2 功能說明

如果使用者有該應用的管理權限，可以點選「匯出API文檔」按鈕，匯出該應用下所有上線API的說明文檔，文檔格式為 Word 。如下圖所示：

線上文檔包含的內容如下：