查询链账户 - 帮助文档

根据文档中给出的具体查询条件，获取与应用方某一项目 ID 相互绑定的链账户地址列表

请求参数

Query 参数

page_key

string

可选

分页数据的Key， Avata会根据该值进行上下页的查询，该值请从返回的数据体中获取，首页查询不传该参数

limit

string

可选

每页记录数，默认为 10，上限为 50

user_id

string

可选

钱包应用项目在创建链账户地址时传入的字段，方便查询某一终端用户的链账户地址信息。该字段值由创建用户接口返回

phone_num

string

可选

钱包应用项目在创建用户时，填入的手机号
📢 注意：参数需要进行 hash 操作，hash 算法为：sha-256

account

string

链账户地址

可选

name

string

可选

链账户名称，支持模糊查询

operation_id

string

可选

操作 ID。此操作 ID 需要填写在请求创建链账户/批量创建链账户接口时，返回的 Operation ID。

start_date

string

可选

创建日期范围 - 开始，yyyy-MM-dd（UTC 时间）

end_date

string

可选

创建日期范围 - 结束，yyyy-MM-dd（UTC 时间）

sort_by

string

可选

排序规则：DATE_ASC / DATE_DESC

count_total

string

可选

是否查询数据的总数量

0：不查询总数（默认）

1：查询总数

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)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200successful operation

application/json

Body

data

object

必需

prev_page_key

string

必需

上一页数据的Key， Avata会根据该值进行上一页数据的查询

next_page_key

string

必需

下一页数据的Key， Avata会根据该值进行下一页数据的查询

limit

integer

每页记录数

必需

total_count

integer

总记录数

可选

read_only

enum<integer>

可选

如果使用【钱包应用】对应的项目参数调用该查询链账户接口时，会返回该字段。
该字段用于区分某一指定链账户地址是否属于当前项目参数所对应的钱包应用。
0: 由当前钱包创建，代表对某一指定地址拥有操作权限
1: 由其他钱包创建，代表对某一指定地址只有只读权限，没有操作权限

枚举值:

accounts

array [object {3}]

链账户列表

必需

示例

{
  "data": {
    "prev_page_key": "string",
    "next_page_key": "string",
    "limit": 0,
    "total_count": 0,
    "accounts": [
      {
        "account": "string",
        "name": "string",
        "operation_id": "string"
      }
    ]
  }
}

🟠400failed operation