创建链账户 - 帮助文档

链账户是应用方或其用户在区块链上的账户地址，用于存储和管理在区块链上所拥有的资产。目前通过 AVATA 平台创建的文昌链原生链账户地址生成即上链，会产生一笔上链交易所需费用（0.05元/个）。建议应用方按照实际会与底层链交互的活跃用户数进行链账户创建。

请求参数

Header 参数

Content-Type

string

必需

固定值：application/json

X-Api-Key

string

必需

项目 API Key，用于 API 访问鉴权

X-Timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

X-Signature

string

必需

API 签名，算法为SHA256(Params+Timestamp+ApiSecret)

Body 参数application/json

name

string

必需

链账户名称，支持 1-20 位汉字、大小写字母及数字组成的字符串

>= 1 字符<= 20 字符

正则匹配:

^[a-zA-Z0-9\u4e00-\u9fa5]+$

operation_id

string

必需

操作 ID，保证幂等性，避免重复请求，保证对于同一操作发起的一次请求或者多次请求的结果是一致的；由接入方生成的、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串组成。此操作 ID 仅限在查询链账户接口中使用，用于查询创建链账户的授权状态。

>= 1 字符<= 64 字符

正则匹配:

^[a-zA-Z0-9_-]+$

示例

{
  "name": "string",
  "operation_id": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200successful operation

application/json

Body

正确返回值与错误返回值是 oneof 关系

data

object

正确返回值

必需

account

string

链账户地址

必需

<= 128 字符

name

string

链账户名称

必需

<= 20 字符

operation_id

string

必需

操作 ID。此操作 ID 仅限在查询链账户接口中使用，用于查询创建链账户的授权状态。

<= 64 字符

示例

{
  "data": {
    "account": "string",
    "name": "string",
    "operation_id": "string"
  }
}

🟠400failed operation