CptService - 7. updateCpt - 《WeIdentity 文档》

7. updateCpt

7. updateCpt

基本信息

接口名称:com.webank.weid.rpc.CptService.updateCpt
接口定义:ResponseData<CptBaseInfo> updateCpt(CptStringArgs args, Integer cptId)
接口描述: 传入cptId，JsonSchema(String类型)，WeIdentity DID，WeIdentity DID所属私钥，进行更新CPT信息，更新成功版本自动+1。

接口入参: com.webank.weid.protocol.request.CptStringArgs，Integer

名称	类型	非空	说明	备注
args	CptStringArgs	Y	CPT信息	具体见下
cptId	Integer	Y	发布的CPT编号

com.webank.weid.protocol.request.CptStringArgs

名称	类型	非空	说明	备注
weIdAuthentication	WeIdAuthentication	Y	认证信息，包含WeIdentity DID和私钥	用于WeIdentity DID的身份认证
cptJsonSchema	String	Y	字符串类型的JsonSchema信息	基本使用见调用示例

com.webank.weid.protocol.base.WeIdAuthentication

名称	类型	非空	说明	备注
weId	String	Y	CPT发布者的WeIdentity DID	WeIdentity DID的格式传入
weIdPublicKeyId	String	N	公钥Id
weIdPrivateKey	WeIdPrivateKey	Y		交易私钥，见下

com.webank.weid.protocol.base.WeIdPrivateKey

名称	类型	非空	说明	备注
privateKey	String	Y	私钥值	使用十进制数字表示

接口返回: com.webank.weid.protocol.response.ResponseData<CptBaseInfo>;

名称	类型	说明	备注
errorCode	Integer	返回结果码	此接口返回的code
errorMessage	String	返回结果描述
result	CptBaseInfo		CPT基础数据，见下
transactionInfo	TransactionInfo	交易信息

com.webank.weid.protocol.response.TransactionInfo

名称	类型	说明
blockNumber	BigInteger	交易块高
transactionHash	String	交易hash
transactionIndex	BigInteger	交易索引

com.webank.weid.protocol.base.CptBaseInfo

名称	类型	说明	备注
cptId	Integer	cpId编号
cptVersion	Integer	版本号

此方法返回code

enum	code	desc
SUCCESS	0	成功
WEID_INVALID	100101	WeIdentity DID无效
WEID_PRIVATEKEY_INVALID	100103	私钥无效
WEID_PRIVATEKEY_DOES_NOT_MATCH	100106	私钥与WeIdentity DID不匹配
WEID_AUTHORITY_INVALID	100109	授权信息无效
CPT_JSON_SCHEMA_INVALID	100301	schema无效
CPT_ID_ILLEGAL	100303	cptId无效
CPT_EVENT_LOG_NULL	100304	交易日志异常
TRANSACTION_TIMEOUT	160001	超时
TRANSACTION_EXECUTE_ERROR	160002	交易错误
UNKNOW_ERROR	160003	未知异常
ILLEGAL_INPUT	160004	参数为空
CPT_NOT_EXISTS	500301	CPT不存在
CPT_ID_AUTHORITY_ISSUER_EXCEED_MAX	500302	为权威机构生成的cptId超过上限
CPT_PUBLISHER_NOT_EXIST	500303	CPT发布者的WeIdentity DID不存在
CPT_ALREADY_EXIST	500304	CPT已经存在
CPT_NO_PERMISSION	500305	CPT无权限

调用示例

CptService cptService = new CptServiceImpl();
 
String jsonSchema = "{\"properties\" : {\"name\": {\"type\": \"string\",\"description\": \"the name of certificate owner\"},\"gender\": {\"enum\": [\"F\", \"M\"],\"type\": \"string\",\"description\": \"the gender of certificate owner\"}, \"age\": {\"type\": \"number\", \"description\": \"the age of certificate owner\"}},\"required\": [\"name\", \"age\"]}";
 
WeIdPrivateKey weIdPrivateKey = new WeIdPrivateKey();
weIdPrivateKey.setPrivateKey("60866441986950167911324536025850958917764441489874006048340539971987791929772");
 
WeIdAuthentication weIdAuthentication = new WeIdAuthentication();
weIdAuthentication.setWeId("did:weid:101:0x39e5e6f663ef77409144014ceb063713b65600e7");
weIdAuthentication.setWeIdPrivateKey(weIdPrivateKey);
 
CptStringArgs cptStringArgs = new CptStringArgs();
cptStringArgs.setCptJsonSchema(jsonSchema);
cptStringArgs.setWeIdAuthentication(weIdAuthentication);
 
Integer cptId = Integer.valueOf(1017);
 
ResponseData<CptBaseInfo> response = cptService.updateCpt(cptStringArgs, cptId);

返回数据如下：
result:(com.webank.weid.protocol.base.CptBaseInfo)
   cptId: 1017
   cptVersion: 3
errorCode: 0
errorMessage: success
transactionInfo:(com.webank.weid.protocol.response.TransactionInfo)
   blockNumber: 29991
   transactionHash: 0x8ed8113dd1772ae74e6f12de3d3716d76a410190c3d564d5d5842b85c7005aee
   transactionIndex: 0