合约服务API调用准备

环境准备

第一步：获取合约服务 ID

调用数字权证合约API，需要先开通数字权证合约服务，并创建好合约服务实例，获得访问该服务所需的合约服务 ID（service_id）。

• 开通数字权证合约服务，相关操作请参见开通流程。

• 创建数字权证合约服务实例，相关操作请参见新建数字权证合约服务。

  创建成功后，在合约列表下单击已创建合约服务实例所在行操作栏下的查看按钮。

  

  在合约服务实例的详情页，即可获得该合约服务实例的service_id。

  

第二步：获取应用ID和对应密钥

创建一个应用，并将已创建的数字权证合约服务实例该应用进行关联，实现应用授权，即可获得应用ID（accessKeyId）和应用密钥（accessKeySecret）。

• 新建一个应用，相关操作可参见新建应用。

• 将应用与数字权证合约服务实例进行关联，相关操作可参见关联合约。

  关联成功后，在应用授权列表下，可以获取关联该合约的应用ID（accessKeyId）和应用密钥（accessKeySecret）。

  

  说明

  您需要单击应用密钥后方的小眼图标，才能明文查看应用密钥。

SDK依赖

业务系统调用合约服务API时，将通过OpenAPI的方式进行调用，为了便于业务应用集成，蚂蚁链提供了7种语言的SDK（JAVA、C#、Go、PHP、Python、TypeScript、Node），供大家集成使用，相应的SDK依赖与使用如下。

JAVA

• SDK地址

• 直接依赖

  <dependency>
      <groupId>com.antgroup.antchain.openapi</groupId>
      <artifactId>openapi-caasplatform</artifactId>
      <version>1.5.1</version>
  </dependency>

• 间接依赖

  <dependency>
    <groupId>com.antgroup.antchain.openapi</groupId>
    <artifactId>antchain-util</artifactId>
    <version>0.1.9</version>
  </dependency>
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>tea-util</artifactId>
    <version>0.2.21</version>
  </dependency>
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>tea-rpc-util</artifactId>
    <version>0.1.3</version>
  </dependency>
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>tea</artifactId>
    <version>1.2.9</version>
  </dependency>
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>oss-util</artifactId>
      <version>1.0.0</version>
  </dependency>

PHP

• SDK版本：1.5.1

• SDK地址

• 管理依赖：composer require antchain/caasplatform

C#

• SDK版本：1.5.1

• SDK地址

• 管理依赖：NuGet\Install-Package AntChain.SDK.CAASPLATFORM -Version 1.4.0

Go

• SDK版本：1.5.1

• SDK地址

• 管理依赖：go get github.com/antchain-openapi-sdk-go/caasplatform

Python

• SDK版本：1.5.1

• SDK地址

• 管理依赖：pip install antchain-caasplatform

TypeScript

• SDK版本：1.5.1

• SDK地址

• 管理依赖：npm i @antchain/caasplatform

Node

• SDK版本： 1.5.1

• SDK地址

• 管理依赖： npm i @antchain/caasplatform