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 字段。