共享信息新增/追加-腾讯云区块链服务平台 TBaaS-文档中心-腾讯云

接口描述
接口名：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
区块时间。
﻿
<style>
    .params{margin-bottom:0px !important;}
</style>

名称	类型	必填	限制	描述
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 时间戳（秒），与服务器时间相差过远会返回失败。

共享信息新增/追加

本页目录：

接口描述

请求示例

应答示例

应答字段解析