更新时间:2023-03-27 GMT+08:00

验证凭证

功能介绍

验证可验证凭证是否存在以及合法性。

URI

POST /v1/identity/verify-vc

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

orgID

是

String

组织id

channelID

是

String

通道id

cryptoMethod

是

String

加密方法,目前固定为SW

cert

是

String

用户证书,每行末尾均需要增加显式换行符\n

sk

是

String

用户私钥,每行末尾均需要增加显式换行符\n

timestamp

是

String

时间戳

vcIndex

是

String

凭证索引

owner

是

String

凭证所有者身份标识

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

isOwned

Boolean

是否拥有

状态码: 400

表3 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

最小长度:8

最大长度:36

errorMsg

String

错误描述

最小长度:2

最大长度:512

状态码: 500

表4 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

最小长度:8

最大长度:36

errorMsg

String

错误描述

最小长度:2

最大长度:512

请求示例

{
  "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198",
  "channelID" : "mychannel",
  "cryptoMethod" : "SW",
  "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----",
  "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----",
  "timestamp" : "2020-10-27T17:28:16+08:00",
  "vcIndex" : 1,
  "owner" : "did:example:ebfeb1f712ebc6f1c276e12ec21"
}

响应示例

状态码: 200

VCVerifyResponeParams Information

{
  "isOwned" : true
}

状态码: 400

失败响应

{
  "errorCode" : "BCS.4002030",
  "errorMsg" : "Owner(bol) does not have credential ..."
}

状态码: 500

失败响应

{
  "errorCode" : "BCS.5002014",
  "errorMsg" : "Internal Server Error"
}

状态码

状态码

描述

200

VCVerifyResponeParams Information

400

失败响应

500

失败响应