更新时间:2023-07-13 GMT+08:00
分享

发布可验证凭证的模板

功能介绍

发布凭证模板数据结构。签发professional类型的凭证时会使用,因为字段较多容易不统一,需要提前有模板来约束和标明。

URI

POST /v1/{project_id}/tdis/credential-schema

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户从IAM申请到的projectid,一般为32位字符串

最小长度:32

最大长度:32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM服务获取的用户Token

最小长度:1

最大长度:16384

表3 请求Body参数

参数

是否必选

参数类型

描述

title

String

名称

最小长度:1

最大长度:50

identifier

String

标识

最小长度:1

最大长度:50

attributes

Array of Attribute objects

属性信息

issuer

String

签发者身份标识

最小长度:20

最大长度:100

表4 Attribute

参数

是否必选

参数类型

描述

name

String

名称

最小长度:0

最大长度:100

type

String

类型

最小长度:0

最大长度:100

description

String

描述信息

最小长度:0

最大长度:200

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

schema_index

String

模板存储在链上的索引

最小长度:22

最大长度:151

credential_schema

CredentialSchema object

CredentialSchema

表6 CredentialSchema

参数

参数类型

描述

creator

String

创建者身份标识

最小长度:20

最大长度:100

title

String

名称

最小长度:1

最大长度:50

identifier

String

凭证模板标识

最小长度:1

最大长度:50

attributes

Array of Attribute objects

属性信息

version

Integer

版本

最小值:1

最大值:2147483647

表7 Attribute

参数

参数类型

描述

name

String

名称

最小长度:0

最大长度:100

type

String

类型

最小长度:0

最大长度:100

description

String

描述信息

最小长度:0

最大长度:200

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度:13

最大长度:13

error_msg

String

错误信息

最小长度:1

最大长度:65535

状态码: 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度:13

最大长度:13

error_msg

String

错误信息

最小长度:1

最大长度:65535

请求示例

{
  "identifier" : "电子身份证模板",
  "attributes" : [ {
    "name" : "name",
    "description" : "Identity number",
    "type" : "someType"
  } ],
  "title" : "电子身份证",
  "issuer" : "did:hwid:JwMoBoTYTK9qSoanwKgQxo"
}

响应示例

状态码: 200

可验证凭证模板

{
  "schema_index" : "did:hwid:JwMoBoTYTK9qSoanwKgQxo_did:hwid:JwMoBoTYTK9qSoanwKgQxo",
  "credential_schema" : {
    "creator" : "did:hwid:JwMoBoTYTK9qSoanwKgQxo",
    "title" : "电子身份证",
    "identifier" : "did:hwid:JwMoBoTYTK9qSoanwKgQxo",
    "attributes" : [ {
      "type" : "someType",
      "name" : "name",
      "description" : "Identity number"
    } ],
    "version" : 1
  }
}

状态码: 400

请求错误

{
  "error_code" : "APAAS.40000002",
  "error_msg" : "Unexpected end of JSON input."
}

状态码: 500

内部错误

{
  "error_code" : "TDIS.50000000",
  "error_msg" : "Internal error. Please contact the service provider."
}

状态码

状态码

描述

200

可验证凭证模板

400

请求错误

500

内部错误

错误码

请参见错误码

分享:

    相关文档

    相关产品