更新时间:2024-06-28 GMT+08:00
分享

验证凭证

功能介绍

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

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

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

失败响应

错误码

请参见错误码

相关文档