包裝函式 API

區塊鏈 App 產生器的增強版本可以產生 API 閘道的包裝函式 API,此 API 支援每個鏈碼方法的專用端點。區塊鏈 App Builder 的增強版本隨附於 Oracle Blockchain Platform Digital Assets Edition。

包裝函式 API 是透過 Oracle Blockchain Platform 端點的抽象層。包裝函式 API 支援設定通用參數和 API 特定端點名稱,可簡化使用方式和清晰度。

Oracle Blockchain Platform 的基本版本中,API 端點需要參數,包括鏈碼名稱、逾時和同步值、引數 (包括方法名稱)、通道名稱和執行處理 URL。這些參數必須與每次呼叫一起傳送。因為大多數這些參數都是所有方法通用的,所以您可以使用包裝函式 API 功能為每個方法建立端點,然後只使用方法參數來呼叫。您可以為每個方法使用自訂端點名稱,而不是使用交易或查詢的通用端點。雖然 Oracle Blockchain Platform 中的 API 端點使用 POST 要求,但包裝函式 API 支援 POST 和 GET 要求。您也可以使用 API 閘道認證機制,使用包裝函式 API 新增額外的驗證層。

下列範例顯示 Oracle Blockchain Platform 中的 createAccount 方法 API。

端點:https://<blockchain_instance>:7443/restproxy/api/v2/channels/<channelName>/transactions

{
    "chaincode": "{{bc-chaincode-name}}",
    "args": [
        "createAccount",
        "{{bc-org-id}}",
        "{{bc-user-id}}",
        "fungible",
        "{\"max_daily_amount\":10000,\"max_daily_transactions\":100}"
    ],
    "timeout": {{bc-timeout}},
    "sync": {{bc-sync}}
}

如果您設定包裝函式 API,可以進行與下列範例中所示相同的方法呼叫。

端點:https://<gateway-hostname>/<deployment-path-prefix>/<route-path>

{
    "orgId": "{{bc-org-id}}",
    "userId": "user1",
    "tokenType": "fungible",
    "dailyLimits": "{\"max_daily_amount\":10000,\"max_daily_transactions\":100}",
}