REST 功能簡介

REST提供合約管理、賬戶管理、合約交易、存證交易、區(qū)塊查詢等螞蟻鏈常用交互功能，以及MYTF鏈下安全計算應用管理和應用執(zhí)行操作功能，同時集成和利用螞蟻生態(tài)中的區(qū)塊鏈基礎服務設施和核心技術能力，包括KMS和TEE，提供多種靈活的區(qū)塊鏈訪問方式，同步/異步調用，外部/內部簽名，普通/私密交易。以下是BaaS REST 可靠上鏈的完整的功能示意圖。REST 接入服務的具體優(yōu)勢如下：

• 標準化接口：跨編程語言標準的RESTful API接口。

• 靈活性編程：支持同步調用、異步調用、主動輪詢、異步消息、托管代簽等模式。

• 可靠性服務：冪等控制、可靠上鏈、可靠推送、異常重試、交易數(shù)據持久化，智能路由能夠選擇最優(yōu)節(jié)點來發(fā)起上鏈交易。

• 穩(wěn)定性保障：限流降級、細粒度監(jiān)控告警。

• 安全性護航：AK/SK及訪問令牌、TEE鏈加密交易

• 高性能支撐：結合數(shù)據分片、水平擴容、交易緩沖等技術，具備日均10億規(guī)模交易處理能力。

獲取REST身份

開通主鏈REST功能

主鏈REST功能開通后，即可在鏈上獲取AccessKey和Access-ID信息，調用REST接口時需要用到此信息，具體操作如下。

1. 登錄阿里云BaaS控制臺，單擊左側導航欄螞蟻區(qū)塊鏈 > 合約鏈，進入我的聯(lián)盟頁。

2. 選擇目標聯(lián)盟，并單擊目標聯(lián)盟所在行右側操作欄下的管理，進入聯(lián)盟內的鏈。

3. 單擊目標聯(lián)盟鏈上的 更多 > 獲取REST身份，在獲取REST身份的彈窗中單擊REST身份即可下載AccessKey。

   

4. 在彈出的下載框中下載AccessKey。

   
   重要

   AccessKey下載后，無法二次獲取，若不慎丟失，請參見下方重置主鏈REST身份，以獲取新的AccessKey。

5. 查看Access-ID 下載AccessKey后，您可以單擊更多 > 查看REST身份，進入Access-ID信息展示界面。

   

重置主鏈REST身份

如果密鑰不慎丟失，您可以單擊更多 > 重置REST身份，重置后，您可以在獲取REST身份的彈窗中，單擊下載獲取新的AccessKey。

重置過程中，您需要發(fā)送驗證碼才能重置成功。

獲取鏈ID

使用SDK參考或HTTP參考方式調用接口時，均需要提前獲取區(qū)塊鏈ID，獲取方式如下。

1. 登錄阿里云BaaS控制臺。

2. 單擊左側導航欄螞蟻區(qū)塊鏈 > 合約鏈，進入我的聯(lián)盟頁。

3. 選擇目標聯(lián)盟，并單擊目標聯(lián)盟所在行右側操作欄下的管理，進入聯(lián)盟內的鏈。

4. 在列表下找到目標聯(lián)盟鏈，區(qū)塊鏈名稱一欄中即可獲取到該目標聯(lián)盟鏈的bizid，即區(qū)塊鏈ID。

   您也可以單擊操作欄中的查看按鈕，在區(qū)塊鏈瀏覽器頁面的URL地址欄中，同樣可以獲取到bizid。

   

Demo工程示例

• Demo工程下載

  點此下載REST Demo工程

• Demo工程簡介

  代碼工程包括：基于BaaS REST的SDK的賬戶托管模式的示例、賬戶非托管模式的示例、TEE鏈的示例以及直接訪問REST接口的相關使用參數(shù)示例。

  下載demo工程后，請詳細閱讀README.md文件，該說明詳細介紹了如何快速使用我們的Demo。