可信账本数据库产品接口支持HTTP调用、CLI调用、SDK调用和OpenAPI Explorer调用。
HTTP调用
您可以通过向服务端发送HTTP Get请求调用云产品API。在使用HTTP方式进行调用时,请求结构如下:
http://Endpoint/?Action=xx&Parameters
其中,
- Endpoint:可信账本数据库API的服务端接入地址为:ledgerdb.aliyuncs.com。
- Action:要执行的操作,如调用CreateLedger创建一个可信账本实例。
- Version:要使用的API版本,可信账本数据库的API版本是2019-11-22。
- Parameters:请求参数,每个参数之间用“&”分隔。
下面是一个调用
CreateLedger
接口创建一个可信账本实例的示例:
说明 为了便于用户查看,本文档中的示例都做了格式化处理。
https://ledgerdb.aliyuncs.com/?Action=CreateLedger
&Format=xml
&Version=2019-11-22
&Signature=xxxx%xxxx%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&Timestamp=2012-06-01T12:00:00Z
…
SDK调用
阿里云可信账本数据库提供Java、Python、Go、.NET、Node.js、PHP、C++语言的SDK。阿里云SDK免去您手动签名的过程,方便使用。下表列举了各语言SDK的Github下载地址。
CLI调用
阿里云命令行工具CLI(Alibaba Cloud CLI)是基于阿里云开放API建立的管理工具。借助此工具,您可以通过调用阿里云开放API来管理阿里云产品。该命令行工具与阿里云开放API一一对应,灵活性高且易于扩展。您可基于该命令行工具对阿里云原生API进行封装,扩展出您想要的功能。更多使用说明,请参见什么是阿里云CLI?。
在阿里云CLI中,调用RPC API时,基本命令结构如下:
aliyun <product> <ApiName> [--parameter1 value1 --parameter2 value2]
代码示例:
aliyun ledgerdb CreateLedger
OpenAPI Explorer调用
OpenAPI Explorer是可视化的API调用工具。通过该工具,您可以通过网页或者命令行调用各云产品以及API市场上开放的API,查看每次的API请求和返回结果,并生成相应SDK调用示例。
您可以直接访问https://api.aliyun.com/调用API,也可以通过API文档中的调试功能进行调用。