API 版本简介

AVATA V3 是基于 v1 和 V2 两个版本，在产品架构、接口功能、核心服务、整体性能等方面都做了较大提升，同时兼容原生模块和智能合约模块；为 AVATA 平台用户提供多种功能与服务的组合使用，助力广大企业及开发者通过 AVATA 平台更加灵活便捷地对接底层链平台，打造开放多元的分布式商业应用。

2023年7月，AVATA V3 版本正式完成升级并发布上线。

V1→V3 的接口调整：

整体调整内容

接口请求路径：域名不变，后缀调整为：/v3/xxxx

多结果查询：查询条件中 offset 均调整为 page_key ；查询条件中新增 count_total ；查询返回的 offset 均调整为 prev_page_key、next_page_key 。

所有枚举值类型由 string(字符)——>int(数字) 。

移除 task_id，operation_id 作为替代字段；移除tag 字段；异步上链交易请求返回结果均不在返回 operation_id 。（除链账户、查询接口）

新增智能合约服务、钱包服务功能。

链账户接口

新增 user_id 字段（为钱包服务提供，普通项目为非必需）。

查询链账户接口中查询条件新增 user_id 查询条件。

创建链账户 和 查询链账户 返回结果新增 native_address、hex_address 字段；移除 account 字段。

NFT 接口

NFT 类别接口：新增 editable_by_owner 字段。

NFT：name 字段调整为非必填。

移除 NFT批量操作接口。

V2→V3 的接口调整

接口请求路径：域名不变，后缀调整为：/v3/xxxx

新增支持原生模块功能接口

新增钱包服务功能

链账户接口

创建链账户 和 查询链账户 返回结果新增 native_address、hex_address 字段。移除 account 字段。

V1→V3 的接口调整：#

整体调整内容#

链账户接口#

NFT 接口#

V2→V3 的接口调整#

链账户接口#

V1→V3 的接口调整：

整体调整内容

链账户接口

NFT 接口

V2→V3 的接口调整

链账户接口