添加账户接口

接口概述

该接口用于在系统中添加一个新的账户。

• 请求方式：POST

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

请求头参数

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

查看详细说明

请求参数

Body 参数（JSON 格式）

参数名	类型	必填	说明
name	String	是	账户名称
platformId	String	是	账户所属平台的主键ID，可通过平台查询接口获取
identity	String	是	账户地址
memo	String	否	备注信息
auxiliaryValueList	Array	否	辅助核算字段列表，只支持文本类型

auxiliaryValueList 数组元素

参数名	类型	必填	说明
name	String	是	辅助核算名称
value	String	是	对应的值，如值不存在则会自动创建

请求示例

{
    "name": "account1",
    "platformId": "zw1dbgFCXmZctjq06FbR4W3Gk8EBn2Iwz",
    "identity": "0xaaa",
    "memo": "这是备注信息",
    "auxiliaryValueList": [
        {
            "name": "counterparty",
            "value": "Counterparty1"
        },
        {
            "name": "text1",
            "value": "value1"
        }
    ]
}

响应参数

参数名	类型	说明
entityAccountId	String	账户的主键ID
name	String	账户名称
platformId	String	平台主键ID
identity	String	账户地址
memo	String	备注信息

响应示例

{
    "entityAccountId": "xxxx",
    "name": "account1",
    "platformId": "xxx",
    "identity": "xxx",
    "memo": ""
}

注意事项

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

• auxiliaryValueList 仅支持文本类型的辅助核算字段。

• 如果 auxiliaryValueList 中的 value 不存在，系统会自动创建该值。