查询链账户
GET
/v3/accounts根据文档中给出的具体查询条件,获取与应用方某一项目 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)
示例代码
返回响应
successful operation(200)
failed operation(400)
successful operation
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
object
必需
prev_page_key
string
上一页数据的Key, Avata会根据该值进行上一页数据的查询
next_page_key
string
下一页数据的Key, Avata会根据该值进行下一页数据的查询
limit
integer
每页记录数
total_count
integer
总记录数
accounts
array [object {5}]
链账户列表
示例
{
"data": {
"prev_page_key": "string",
"next_page_key": "string",
"limit": 0,
"total_count": 0,
"accounts": [
{
"native_address": "string",
"hex_address": "string",
"name": "string",
"operation_id": "string",
"read_only": 0
}
]
}
}
修改于 10 个月前