文档首页/ 可信分布式身份服务 TDIS/ API参考/ API/ 可验证凭证/ 发布可验证凭证的模板
更新时间：2023-07-13 GMT+08:00
查看PDF
分享

发布可验证凭证的模板

功能介绍

发布凭证模板数据结构。签发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

内部错误

错误码

请参见错误码。

父主题： 可验证凭证

相关文档