共享信息新增/追加
请求地址:http://{node_ip:node_port}/Iss_Append (node_ip:节点的内网/外网ip, node_port:15903)
请求方法:POST
请求字段:
名称 类型 必填 限制 描述 version string 是 length >=1 length <=8 版本号,本版本固定填写“2.0” sign_type string 是 length >=0 length <=8 签名算法类型,本版本固定为“ECDSA” mch_id string 是 length >=1 length <=32 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取) mch_pubkey string 是 length >=1 length <=256 通讯方公钥(可使用SDK生成,在测试链中:该公钥为用户在BaaS平台【我的账户】中上传的公钥;在专属链中:该公钥为用户在节点管理平台上传的公钥。) mch_sign string 是 length >=1 length <=256 通讯方签名结果 chain_id string 是 length >=1 length <=32 链ID content jsonObject 是 记录内容。由业务自行定义。采用标准的双引号而非单引号来封装key和value,请求参数中不能转义双引号。 extra_info jsonObject 是 扩展信息。由业务自行定义,长度大小不限,建议不超过4K字节,以免性能下降过多。业务对记录内容的分类或管理规则可放这里配置 account string 是 length >=1 length <=64 记录方地址(用户可通过SDK生成的区块链地址直接进行使用,无需注册,该地址与真实用户之间的对应关系可由业务方进行维护) public_key string 是 length >=1 length <=256 记录方公钥(用户可通过SDK生成的区块链公私钥对中的公钥直接进行使用,私钥自行保存,无需注册,该公钥与真实用户之间的对应关系可由业务方进行维护) sign string 否 length >=0 length <=256 选项1:请求留空本字段,会返回待签名串;选项2:将选项1返回的待签名串调用SDK函数SignRenString进行签名,将签名结果作为sign的参数值,再次请求本协议来真正写入 timestamp int64 是 value >=0 请求时间戳。当前unix时间戳(秒),与服务器时间相差过远会返回失败 请求示例:
http://{node_ip:node_port}/Iss_Append
{
"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",
"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 | 是 | length >=1 length <=8 | 版本号,本版本固定填写“2.0” |
sign_type | string | 否 | length >=0 length <=8 | 签名算法类型,本版本固定为“ECDSA” |
mch_id | string | 是 | length >=1 length <=32 | 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取) |
mch_sign | string | 是 | length >=1 length <=256 | 通讯方签名结果 |
retcode | int32 | 是 | value >=1 value <=32 | 返回状态码。0表示成功,其它为失败 |
retmsg | string | 是 | length >=0 length <=64 | 返回信息,如非空,为错误原因。 |
sign_str | string | 否 | length >=0 | 待签名串,当返回签名信息时返回 |
t_hash | string | 否 | length >=0 length <=64 | 记录哈希 |
b_height | string | 否 | length >=0 | 区块高度 |
b_time | string | 否 | length >=0 length <=64 | 区块时间 |
返回顶部