接口描述
注意
申请和提交要在同一个节点上操作。
此接口用于转让签收场景。
接口名称:asset_mult_transfer_mid_apply
请求方法:POST
请求字段:如下表
名称 | 类型 | 必填 | 限制 | 描述 |
version | String | 是 | 1 ≤ length ≤ 8 | 版本号,此版本固定填写“2.0”。 |
sign_type | String | 是 | 0 ≤ length ≤ 8 | 签名算法类型,此版本固定为 “ECDSA”。 |
mch_id | String | 是 | 1 ≤ length ≤ 32 | |
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_account | String | 否 | 0 ≤ length ≤ 64 | 手续费转入账户。 |
fee_account_pubkey | String | 否 | 1 ≤ length ≤ 64 | 手续费转入账户公钥。 |
mult_assets | message 数组 | 是 | - | 转出账户持有的待转入的资产信息列表。 |
mult_assets.asset_id | String | 是 | 0 ≤ length ≤ 64 | 源资产的资产 ID(不可重复)。 |
mult_assets.dst_amount | int64 | 是 | value ≥ 0 | 该笔资产中计划转让出的资产份额。 |
mult_assets.fee_amount | int64 | 否 | value ≥ 0 | 该笔资产在本次交易中计划出让的手续费。 |
asset_type | uint64 | 是 | 0 ≤ value ≤ 32 | 资产类型。 |
sign_in_date | String | 否 | 1 ≤ length ≤ 32 | 要求签收时间。 |
extra_info | jsonObject | 否 | - | 扩展信息。 |
timestamp | int64 | 是 | value ≥ 0 | 当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。 |
请求示例
{"mch_sign": "MEUCIQCkFg2DQ/7ZoKOehZ89c4E/En0nwOAAlIMJ3OLlVWnpxwIgd7maE0B5ZeHEzLLTT2jIFtP5Lh+3Vor4TCkPl19Wwkc=","src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD","dst_account_pubkey": "A7eOlbe9QtU8YJwSdAg09e6xXkOwdSeIUwJxGDRJ3bpl","dst_uid": "dst_uid8023","mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO","timestamp": "1546076196","fee_account_pubkey": "AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW","fee_account": "1HwaHaTd1Vr8EPaNMgez8jgrzBVsEMVaYk","chain_id": "chain_id","node_id": "node_id","mult_assets": [{"asset_id": "26aPEzZLfrsFz98gBgEFdHRxjx5Ssbarv6bxy4D2dhNvT8A","fee_amount": 0,"dst_amount": "10000000000000"},{"asset_id": "26aKBUoUXjx6MAnKnp83bm2iwikAEshTPfTfX6dprAqsy2A","fee_amount": 0,"dst_amount": "10000000000000"}],"dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD","sign_in_date": "2018-12-29 17:36:36","mch_id": "mch_id","version": "2.0","sign_type": "ECDSA","src_account_pubkey": "AilPJBYrDQjXiJ4Wr7hjUTZjvhdODzZVqRw80N1terbc","asset_type": 1,"src_uid": "owner_uid5848","extra_info": {"extra_info": "test_extra_info"}}
应答示例
{"version": "2.0","sign_type": "ECDSA","mch_id": "trust_mch","mch_sign": "MEYCIQDyh4L9wvOTC1ztKOhzOkKa6cke4uDhzEPigX4yrC5BFAIhAJdYNnkEBzigvSpAb8KQecpkp10SD6qpaI0uvLezW7Pk","chain_id": "chain_id","retcode": 0,"retmsg": "SUCCESS","transaction_id": "201812290005782272","sign_str_list": [{"id": 1,"account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD","sign_str": "116e64e026da1e552f4cd44f283ffda994ca4bd142b5864b18794087caee82b3"},{"id": 2,"account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD","sign_str": "b5558aa692b1c19b8951776db17960faa1e5d986ec2bc7cf4baf99301bcabe43"}],"mid_asset_id": "26aKQ3ud2xU2uC9AemUmYKFaxsk7TLJUdtwS8YgEcLAnAmu","mid_address": "35tziTANAMtS2wwGUXbZ14BW37GM9wT2Gc","mch_pubkey": "AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW"}
应答字段解析
名称 | 类型 | 必填 | 限制 | 描述 |
version | String | 是 | 1 ≤ length ≤ 8 | 版本号,此版本固定填写“2.0”。 |
sign_type | String | 是 | 1 ≤ length ≤ 8 | 签名算法类型,此版本固定为 “ECDSA”。 |
mch_id | String | 是 | 1 ≤ length ≤ 32 | |
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 | 否 | - | 签名串。 |
mid_asset_id | String | 否 | 0 ≤ length ≤ 64 | 待签收账户资产 ID。 |
mid_address | String | 否 | 0 ≤ length ≤ 64 | 待签收账户地址。 |
mch_pubkey | String | 是 | 1 ≤ length ≤ 64 | 通讯方公钥(支持1.2以上版本)。 |