文档中心>腾讯云区块链服务平台 TBaaS

共享信息新增/追加

最近更新时间:2020-06-01 19:33:33

我的收藏

接口描述

接口名: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>