资产直接转让申请

最近更新时间:2019-10-30 10:21:40

接口描述

注意:

  • 申请和提交要在同一个节点上操作。
  • 此接口用于非签收场景。

接口名:asset_transfer_apply
请求方法:POST
请求字段:如下表

名称 类型 必填 限制 描述
version String 1 ≤ length ≤ 8 版本号,此版本固定填写“2.0”。
sign_type String 0 ≤ length ≤ 8 签名算法类型,此版本固定为 “ECDSA”。
mch_id String 1 ≤ length ≤ 32 通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。
mch_sign String 1 ≤ length ≤ 256 通讯方签名结果。
chain_id String 1 ≤ length ≤ 32 网络 ID。
node_id String 1 ≤ length ≤ 32 节点 ID。
mch_pubkey String 1 ≤ length ≤ 64 节点公钥。用户可在 TrustSQL 控制台,节点列表的节点公钥处上传。
src_uid String 1 ≤ length ≤ 64 资产转出方(即资产发行方、资产所有者)的 UID。
src_account String 1 ≤ length ≤ 64 资产转出方(即资产发行方、资产所有者)的账户地址。
src_account_pubkey String 1 ≤ length ≤ 64 资产转出方(即资产发行方、资产所有者)的账户公钥。
dst_uid String 1 ≤ length ≤ 64 资产转入账户 UID。
dst_account String 1 ≤ length ≤ 64 资产转入账户。
dst_account_pubkey String 1 ≤ length ≤ 64 资产转入帐户公钥。
fee_uid String 1 ≤ length ≤ 64 资产收费账户 UID。
fee_account String 0 ≤ length ≤ 64 手续费转入账户。
fee_account_pubkey String 0 ≤ length ≤ 64 手续费转入账户公钥。
asset_type uint64 value ≥ 0 资产类型。
src_asset_list String 0 ≤ length ≤ 1024 待转让的资源持有方拥有的资产 ID 列表。
amount int64 value ≥ 0 转让份额。
fee_amount int64 value ≥ 0 手续费份额。
extra_info jsonObject - 扩展信息。
timestamp int64 value ≥ 0 当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。

请求示例

{
    "mch_sign": "MEQCIAGPeCzmK3zabQAXl6YsbH0g55nCaXlj2IEhCktCUtzVAiB6Y4LVhAVwA5UgZYmtLhE5gWqIS5txmt5WkUH2pL/4zg==",
    "src_account_pubkey": "AilPJBYrDQjXiJ4Wr7hjUTZjvhdODzZVqRw80N1terbc",
    "dst_account_pubkey": "A7eOlbe9QtU8YJwSdAg09e6xXkOwdSeIUwJxGDRJ3bpl",
    "dst_uid": "dst_uid8782",
    "src_uid": "owner_uid8835",
    "fee_account": "1HwaHaTd1Vr8EPaNMgez8jgrzBVsEMVaYk",
    "timestamp": "1546075391",
    "fee_account_pubkey": "AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW",
    "chain_id": "chain_id",
    "node_id": "node_id",
    "fee_uid": "fee_uid6217",
    "fee_amount": "1",
    "mch_id": "mch_id",
    "version": "2.0",
    "amount": "4308",
    "sign_type": "ECDSA",
    "src_asset_list": "26aBk2Zv5qCiRNX297fSBQbRBZb3fYdPN2KmpPqStqdY4Jf",
    "dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD",
    "src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
    "asset_type": 0,
    "mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
    "extra_info": {
        "test": "test"
    }
}

应答示例

{
    "version": "2.0",
    "sign_type": "ECDSA",
    "mch_id": "trust_mch",
    "mch_sign": "MEYCIQCirPZWE31l1yfPdZ/VqDwnNzkXwZzWtfQ8Pg5yFwrI+wIhAOjUmEY62WopLEt8bgp8DnDqmew/h5w1PskjFVLArQ+j",
    "chain_id": "chain_id",
    "retcode": 0,
    "retmsg": "SUCCESS",
    "transaction_id": "201812290005782265",
    "sign_str_list": [
        {
            "id": 1,
            "account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
            "sign_str": "797f1cee8eb5b86a6214aad8f3c90f6b55a67161201c7047ae9178e838b314c7"
        }
    ],
    "left_asset_id": "29CXPq4LQBEvsqbHsYSgVD73GPwDpZQ6WcMkD5cFk8jdAeo",
    "dst_asset_id": "26aRqfJCXJ6SiJ9FecaNeKKzFiuGy5vfxTx88h7a7VmDUdZ",
    "mch_pubkey": "AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW"
}

应答字段解析

名称 类型 必填 限制 描述
version String 1 ≤ length ≤ 8 版本号,此版本固定填写“2.0”。
sign_type String 1 ≤ length ≤ 8 签名算法类型,此版本固定为 “ECDSA”。
mch_id String 1 ≤ length ≤ 32 通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。
mch_sign String 1 ≤ length ≤ 256 通讯方签名结果。
chain_id String 1 ≤ length ≤ 32 网络 ID。
retcode int32 - 应答 code,成功时为0。
retmsg String - 应答信息,成功时内容为 SUCCESS。
transaction_id String 1 ≤ length ≤ 32 唯一标识一次交易的 ID。
sign_str_list message 数组 0 ≤ length ≤ 64 待签名串。
sign_str_list.id int32 - 序号。
sign_str_list.account String - 签名账户。
sign_str_list.sign_str String - 签名串。
left_asset_id String 0 ≤ length ≤ 64 找零资产 ID。
dst_asset_id String 0 ≤ length ≤ 64 转出资产 ID。
mch_pubkey String 1 ≤ length ≤ 64 通讯方公钥(支持1.2以上版本)。