共享信息新增/追加

最近更新时间:2019-10-30 10:22:39

接口描述

接口名:Iss_Append
请求方法: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。
content jsonObject - 记录内容,由业务自行定义。采用标准的双引号而非单引号来封装 key 和 value,请求参数中不能转义双引号。
extra_info jsonObject - 扩展信息,由业务自行定义。长度大小不限,建议不超过4K字节,以免性能下降过多。业务对记录内容的分类或管理规则可在此配置。
account String 1 ≤ length ≤ 64 记录方地址。用户可通过 SDK 生成的区块链地址直接进行使用,无需注册,该地址与真实用户之间的对应关系可由业务方进行维护。
public_key String 1 ≤ length ≤ 256 记录方公钥。用户可通过 SDK 生成的区块链公私钥对中的公钥直接进行使用,私钥自行保存,无需注册,该公钥与真实用户之间的对应关系可由业务方进行维护。
sign String 0 ≤ length ≤ 256
  • 选项1:请求留空本字段,会返回待签名串。
  • 选项2:将选项1返回的待签名串调用 SDK 函数 SignRenString 进行签名,将签名结果作为 sign 的参数值,再次请求本协议来真正写入。
timestamp int64 value ≥ 0 请求时间戳。当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。

请求示例

{
    "mch_sign":"MEQCID0FuZnQUmzTFlokvIOr0WOhraDMAKRuyolhuy2O/dX4AiBsM23VBz8eCQ50KW3cMPj/HpejQ6FL427uW9DDFdmRvw==",
    "public_key":"A+5qT01+29y+dhYrZq3QW9pVWmW24DKJDn505XPJz/pI",
    "account":"1FxHszg3ctmFudZzYQQnduN2Pan8NNygvW",
    "mch_pubkey":"A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
    "timestamp":"1535955749",
    "chain_id":"chain_id",
    "node_id": "node_id",
    "sign":"MEQCIFx9gt7S2DJCOk5I9+k13libIgC1o/htswBFlE5eDP7LAiAdwCZI1Zxv11cMOk69Y7CXRahRYO4aty9U7X5UmGgZFQ==",
    "content":{
        "test":"content_8804177188"
    },
    "mch_id":"mch_id",
    "version":"2.0",
    "sign_type":"ECDSA",
    "extra_info":{
        "test":"test"
    }
}

应答示例

{
    "version":"2.0",
    "sign_type":"ECDSA",
    "mch_id":"trust_mch",
    "mch_sign":"MEYCIQDo4IOwpxsHApDU7XZTBOG4LbT2oJCG0FGV53j7JF3nNwIhAIXbE2sPKGYIbZ7riixirww5UPBL9mvXxQQyjxlOHY4V",
    "retcode":0,
    "retmsg":"SUCCESS",
    "t_hash":"30dd11831f35855e2f9fe32933333b00f44af0111b46216dd6462da46c3313d8",
    "b_height":"107234",
    "b_time":"2018-09-03 14:27:07"
}

应答字段解析

名称 类型 必填 限制 描述
version String 1 ≤ length ≤ 8 版本号,此版本固定填写“2.0”。
sign_type String 1 ≤ length ≤ 8 签名算法类型,此版本固定为 “ECDSA”。
mch_id String 1 ≤ length ≤ 32 通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。
chain_id String 1 ≤ length ≤ 32 网络 ID。
mch_sign String 1 ≤ length ≤ 256 通讯方签名结果。
retcode int32 1 ≤ value ≤ 32 返回状态码。0表示成功,其它为失败。
retmsg String 0 ≤ length ≤ 64 返回信息,如非空,为错误原因。
sign_str String length ≥ 0 待签名串,当返回签名信息时返回。
t_hash String 0 ≤ length ≤ 64 记录哈希。
b_height String length ≥ 0 区块高度。
b_time String 0 ≤ length ≤ 64 区块时间。