可信账本数据库产品接口支持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:请求参数,每个参数之间用“&”分隔。
    • 请求参数由公共请求参数和API自定义参数组成。公共参数中包含API版本号、身份验证和签名等信息,详情请参见公共参数
    • 在使用HTTP方式调用API接口时,您需要进行签名计算以保证账号安全,详细说明请参见签名机制
下面是一个调用 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下载地址。

SDK GitHub下载地址
Java SDK 下载地址
Python SDK 下载地址
Go SDK 下载地址
.NET SDK 下载地址
PHP SDK 下载地址
C++ 下载地址

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文档中的调试功能进行调用。