共享信息新增/追加

  • 请求地址: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 区块时间
返回顶部