资产转让签收提交

最近更新时间:2019-10-31 12:09:08

接口描述

注意:

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

接口名: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 通讯方的 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 控制台,节点列表的节点公钥处上传。
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 通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。
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以上版本)。