验证凭证
功能介绍
验证可验证凭证是否存在以及合法性。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/identity/verify-vc
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
orgID |
是 |
String |
组织id |
channelID |
是 |
String |
通道id |
cryptoMethod |
是 |
String |
加密方法,目前固定为SW |
cert |
是 |
String |
用户证书,每行末尾均需要增加显式换行符\n |
sk |
是 |
String |
用户私钥,每行末尾均需要增加显式换行符\n |
timestamp |
是 |
String |
时间戳 |
vcIndex |
是 |
String |
凭证索引 |
owner |
是 |
String |
凭证所有者身份标识 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
isOwned |
Boolean |
是否拥有 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
errorCode |
String |
错误码 最小长度:8 最大长度:36 |
errorMsg |
String |
错误描述 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
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 |
失败响应 |
错误码
请参见错误码。