包裝函式 API

增強版的區塊鏈 App 產生器可以產生 API 閘道包裝函式 API,此 API 支援每個鏈碼方法的專用端點。

包裝函式 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.example.com:7443/restproxy/api/v2/channels/default/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://apigateway.example.com/appbuilder/createAccount

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