包裝函式 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}",
}