账户查询接口

接口概述

该接口用于查询系统中的账户列表，支持分页查询。

• 请求方式：GET

• 请求URL：https://openapi.elven.com/open/v3/entityAccount

请求头参数

参数名	类型	必填	说明
elven-api-key	String	是	分配给您的API密钥
elven-api-sign	String	是	请求签名，用于验证请求合法性
elven-api-timestamp	String	是	请求时间戳，毫秒级

查看详细说明

请求参数

Query 参数

参数名	类型	必填	说明
page	Number	否	页码，为空视为1
limit	Number	否	每页条数，为空视为10

请求示例

GET https://openapi.elven.com/open/v3/entityAccount?page=1&limit=10

响应参数

参数名	类型	说明
total	Number	结果数量
list	Array	账户列表

list 数组元素

参数名	类型	说明
entityAccountId	String	账户的主键ID
name	String	账户名称
platformId	String	平台主键ID
identity	String	账户地址
memo	String	备注信息
auxiliaryValueList	Array	账户辅助核算字段信息 auxiliaryTypeName：辅助核算字段名称 auxiliaryTypeId：辅助核算字段的值 auxiliaryItemValue：如果当前辅助核算是文本类型的辅助核算字段，会返回对应文本选项内容 auxiliaryTypeId：如果当前辅助核算是文本类型的辅助核算字段，会返回对应文本选项的 id counterpartyName：如果当前辅助核算是对手方类型的辅助核算字段，会返回对应对手方的名称 counterpartyId：如果当前辅助核算是对手方类型的辅助核算字段，会返回对应对手方id

响应示例

{
    "total": 100,
    "list": [
        {
            "entityAccountId": "xxxx",
            "name": "account1",
            "platformId": "xxx",
            "identity": "xxx",
             "auxiliaryValueList": [
                    {
                        "auxiliaryTypeName": "Counterparty",
                        "counterpartyName": "customer01",
                        "counterpartyId": "MHVuIUrKPrUuVB0e519dH8SbTa3N4jDC",
                        "auxiliaryTypeId": "xs4NuYCtH9nPdmiXOCl8qZbFDJ1B6SWY"
                    },
                    {
                        "auxiliaryTypeName": "BU",
                        "auxiliaryItemValue": "BU1",
                        "auxiliaryItemId": "oKSGm0VqRNP0WdT1B7IRYCwryjhFtfi9",
                        "auxiliaryTypeId": "9eCjkxpGkOuhc8QewtTI1Cm0qsA3aVn5"
                    }
                ],
            "memo": ""
        },
        {
            "entityAccountId": "yyyy",
            "name": "account2",
            "platformId": "yyy",
            "identity": "yyy",
            "memo": "这是第二个账户"
        }
    ]
}

在线调试

您可以通过 Apifox 服务进行接口的在线调试：https://zswsuv3jhf.apifox.cn/api-253901218

注意事项

• 请求头中的 elven-api-key、elven-api-sign 和 elven-api-timestamp 为必填参数，用于验证请求的合法性和安全性。

• page 和 limit 参数为可选参数，不传递时默认返回第一页，每页10条数据。

• 返回结果中的 list 数组包含账户的详细信息，每一项与添加账户接口的返回值格式一致。