验证凭证
功能介绍
验证可验证凭证是否存在以及合法性。
调试
您可以在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 | 失败响应 | 
错误码
请参见错误码。
 
  