5.4.6.11 链码事件注册接口

  可以通过该接口注册cita的出块事件或者合约事件,当事件被触发时,系统将向注册的通知地址发送事件内容。

  1. 接口地址:https://节点网关地址/api/cita/v1/event/register

  2. 通讯方式: POST

  3. 签名算法:详见5.4.6.1应用接入签名算法

  4. 请求参数

序号 字段名 字段 类型 必填 备注
1 信息头 header Map
2 信息体 body Map
3 签名值 mac String
header
1 用户唯一标识 userCode String
2 应用唯一标识 appCode String
Body
1 事件类型 eventType String 1:出块事件
2:合约事件
2 合约地址 contractAddress String EventType为1时可以为空,为2时,不可与contractName同时为空
3 合约名 contractName String EventType为1时可以为空,为2时,不可与contractAddress同时为空
4 通知地址 notifyUrl String
5 附件参数 attachArgs String

  示例

    {"header":{"userCode":"USER0001202006042321579692440","appCode":"app0001202006042323057101002","tId":""},"mac":"MEUCIQCMP1ToZS5e8S94kYZ/8y5XfeyjRyUrPFpeIQMES3SGpQIgO8b6O8Kk/qpNTo1vbNTwyAYNaw6HBi9OkAH8Rp23j8s=","body":{"eventType":1,"contractAddress":"0x866aefc204b8f8fdc3e45b908fd43d76667d7f76","contractName":"BsnBaseContractk1","notifyUrl":"http://127.0.0.1:18080","attachArgs":"abc=123"}}

  5. 响应参数

序号 字段名 字段 类型 必填 备注
1 信息头 header Map
2 信息体 body Map
3 签名值 mac String
header
1 响应标识 code int 0:校验成功
-1:校验失败
2 响应信息 msg String
body
1 事件Id eventId string code不为0时为空

  示例

    {
    "header": {
    "code": 0,
    "msg": "处理成功"
    },
    "mac": "MEUCIQDYSTwYhh6EDHT5Z7ukcqXW9LMjZW6WPnrv8Xt14RuH2AIgIwa5K7NK4/TThzs8z6VfkpNNJU+dzAXeypFmfjkru88=",
    "body": {
    "eventId": "xxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
    }
Copyright 北京红枣科技有限公司

results matching ""

    No results matching ""

    results matching ""

      No results matching ""