接口描述
注意
申请和提交要在同一个节点上操作。
此接口用于转让签收场景。
接口名:asset_mult_signin_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 控制台,节点列表的节点公钥处上传。 |
asset_type | uint64 | 是 | 0 ≤ value ≤ 32 | 资产类型。 |
transaction_id | String | 是 | 1 ≤ length ≤ 32 | 唯一标识一次交易的 ID。 |
sign_list | jsonArray | 是 | 0 ≤ length ≤ 64 | 原待签名串和签名结果。 |
sign_list.id | int32 | 是 | - | 序号。 |
sign_list.account | String | 是 | - | 签名账户。 |
sign_list.sign_str | String | 是 | - | 签名串。 |
sign_list.sign | String | 是 | - | 签名结果。 |
timestamp | int64 | 是 | value ≥ 0 | 当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。 |
请求示例
{"mch_sign": "MEQCIHicXn6Td9qf9gtKw+Az3fSoB0AOGPaHb15bdwJZfakOAiBp1TU4t6gZtFI9JMflDcUfqTpLGtMjY25V9PXl++CqVA==","mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO","timestamp": "1545028367","sign_list": [{"account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD","sign_str": "57bdafdc5fbc3d3f525cdafa2e111e008e5fd7d82271b646b3cba6ed764cd71c","id": 1,"sign": "MEUCIQDezlBDHkOvhbIZtetAwaidy/am2gTUYHbdd09N+7b0uwIgDn1J5DhywM2kc4EhbmFupFAuQ7ASpCS5HaQmxpUVCjU="}],"chain_id": "chain_id","node_id": "node_id","mch_id": "mch_id","version": "2.0","sign_type": "ECDSA","asset_type": 1,"transaction_id": "201812170005782168"}
应答示例
{"version":"2.0","sign_type":"ECDSA","mch_id":"trust_mch","mch_sign":"MEYCIQCgaSxh88WowFqR1KJcdIzZEnO9LFVvlnGOT/VWHVNAjQIhAOxdsDsQhdzRqr7vws8wMSvZwnmskMjti40AwKaRrPlO","chain_id":"chain_id","retcode":0,"retmsg":"SUCCESS","dst_asset_list":[{"asset_id":"26aABkh7XFdxeEitdf23WPdi7VpfyN2QUqceKSRh4Ufuqcm","amount":9999999999997},{"asset_id":"29CFjvTFQ8nSonAvratMMHQm8ArcpqVq2z2GPpvNh7eKXe1","amount":10000000000000}],"fee_asset_list":[{"asset_id":"27tCxqaBThDCj1Suk7xCRqXEcqLeQ6m7kupTMdg2soA7gdP","amount":1},{"asset_id":"2AWJX1LKLaMgtYtwy3pWGjJHdWNbFaEYK4E5S2AiWS8XNed","amount":0}],"trans_hash":"14dcd86d7e3046fed08913ecddc6ca2b297b8084d89dd499340a3043c7567ffa","trans_b_height":2574,"trans_b_timestamp":1545028412,"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。 |
dst_asset_list | message 数组 | 否 | - | 签入的转入资产信息列表。 |
dst_asset_list.asset_id | String | 否 | 0 ≤ length ≤ 64 | 资产 ID。 |
dst_asset_list.amount | int64 | 否 | value ≥ 0 | 资产中具有的金额。 |
fee_asset_list | message 数组 | 否 | - | 手续费的资产信息列表。 |
fee_asset_list.asset_id | String | 否 | 0 ≤ length ≤ 64 | 资产 ID。 |
fee_asset_list.amount | int64 | 否 | value ≥ 0 | 资产中具有的金额。 |
trans_hash | String | 否 | 0 ≤ length ≤ 64 | 区块链交易 Fhash 值。 |
trans_b_height | int64 | 否 | - | 区块链交易高度。 |
trans_b_timestamp | int64 | 否 | value ≥ 0 | 区块时间。 |
mch_pubkey | String | 是 | 1 ≤ length ≤ 64 | 通讯方公钥(支持1.2以上版本)。 |