5.4.6.5 密钥托管模式下调用智能合约接口
链下业务系统在连接节点网关时,需要按照接口说明在请求中加入相应的请求参数,调用节点网关以后,节点网关会返回智能合约的执行结果。
1. 接口地址:https://节点网关地址/api/cita/v1/node/reqChainCode
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 | 用户ID | userId | String | 是 | 用户通过5.4.6.4注册接口注册的用户的id |
2 | 合约名称 | contractName | String | 是 | |
3 | 方法名称 | funcName | String | 是 | |
4 | 方法参数 | funcParam | String | 否 | 将array格式的参数转为json字符串赋值 |
示例
{
"header":{"appCode":"cl0006202003181926573677572",
"userCode":"USER0006202003181951281835816"},
"body":{"contractName":"HelloWorld","userId":"100003","funcName":"set","funcParam":["abc"]},
"mac":"MEUCIQDTFe2Gerdf7YJrG1a1Yt99M0ZQ3T1lGpsXdNmFV7WuTgIgSkZ19abUhAJbMrJMBoD8N7f26xhpQRuR4vNAfY7EEbs="
}
5. 响应参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 响应标识 | code | int | 是 | 0:校验成功 -1:校验失败 |
2 | 响应信息 | msg | String | 否 | code=0时可为null |
body: | |||||
1 | 交易hash | txId | String | 否 | |
2 | 交易状态 | status | String | 否 | |
3 | 查询数据 | data | Object | 否 | 合约查询方法时返回 |
示例
{"header":{"code":0,"msg":"success"},"mac":"MEUCIQCK8BZmcWf2KqINJLFMF8ey3Z7DdmLEg2waNIMtR/S/aQIgUjwQTooGkLW2Y3jxYMyVlG92Gafsrcu2i2+jbwFFoPw=","body":{"txId":"0xfd15b9d8440a0132ff6d773cf3f99c3aa28d16ae44079dce2eae9e10be5a75f9","status":"OK","data":""}}