5.4.3.4 用户注册接口
在密钥托管和上传公钥两种模式下,当参与Fabric应用的用户需要为链下系统的子用户单独创建用户交易密钥证书时,需要先调用该接口注册本城市节点下的用户,用户的用户名为调用参数中的name@appCode
1. 接口地址: https://节点网关地址/api/fabric/v1/user/register
2. 通讯方式:POST
3. 签名算法:详见5.4.3.1应用接入签名算法
4. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 否 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 用户唯一标示 | userCode | String | 是 | |
2 | 应用唯一标识 | appCode | String | 是 | |
body: | |||||
1 | 用户名 | name | String | 是 | 长度小于20 |
2 | 用户密码 | secret | String | 否 | 密钥托管模式的应用可为空,上传公钥模式的应用为空时将返回随机密码 |
3 | 扩展属性 | extendProperties | String | 否 | 用户扩展属性,json格式字符串 |
示例:
{
"header":{
"userCode":"USER0001202101301022113596689",
"appCode":"app0001202109171125562435760",
"tId":""
},
"mac":"MEQCID3F4z2XpN4JsCU/gRO9l0Ziw1IOICx8eVgVWUVltvWyAiA1Y0uObgCV5tm1avSz9BscYr1aycmfBtFSlQ3o19OYEQ==",
"body":{
"name":"user20210927",
"secret":"123456",
"extendProperties":"{'key1':'value'}"
}
}
5. 响应参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 响应标识 | code | String | 是 | 0:成功 -1:失败 |
2 | 响应信息 | msg | String | 是 | |
body: | |||||
1 | 用户名 | name | String | 是 | 长度小于20 |
2 | 用户密码 | secret | String | 是 | 上传公钥模式应用请求参数密码为密码空时返回随机密码 |
示例:
{
"header":{
"code":"0",
"msg":"处理成功"
},
"mac":"MEUCIQClfufMU8kRI1gMHIGqfWOh1iv2KIhS+H0dlUUdEuUrLQIgYJz9<br>8xp5w/KdVP6bJjHhV2pZPTe9Cn4xcOrPV4E7ZsA=",
"body":{
"name": "user01",
"secret": "123456"
}
}