1. 接口描述
接口请求域名： tdid.tencentcloudapi.com 。
创建凭证持有人的可验证表达
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：CreatePresentation。 |
| Version | 是 | String | 公共参数，本接口取值：2021-05-19。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| DAPId | 否 | Integer | DID应用id 示例值：1 |
| Credentials.N | 否 | Array of String | 凭证列表 示例值：[] |
| Did | 否 | String | VP持有人的DID标识 示例值：did:tdid:c52:0xfd28ad212a2de77fee518b4914b8579a40c601fa |
| VerifyCode | 否 | String | VP随机验证码 示例值：test |
| PolicyJson | 否 | String | 选择性披露策略 示例值：{} |
| Unsigned | 否 | Boolean | 是否签名，ture时signatureValue为待签名内容由调用端自行签名，false时signatureValue为平台自动已签名的内容。默认false 示例值：true |
| CredentialList.N | 否 | Array of CredentialProof | 可验证凭证证明列表 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| PresentationData | String | 可验证表达内容 示例值："" |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 创建可验证表达
输入示例
POST / HTTP/1.1
Host: tdid.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreatePresentation
<公共请求参数>
{
"DAPId": 1,
"CredentialList": [
{
"Credential": "{\"cptId\":1,\"issuer\":\"did:tdid:w1:0x379106c7232aed1a50e8600511655b479c76b149\",\"expirationDate\":\"2124-06-29T15:25:00+08:00\",\"issuanceDate\":\"2023-11-30T05:19:40+08:00\",\"context\":\"https://github.com/TencentCloud-Blockchain/TDID/blob/main/context/v1\",\"id\":\"0767cc1f93ad541e195bd9f5f00d665f\",\"type\":[\"VerifiableCredential\"],\"credentialSubject\":{\"action\":\"deactiveDid\",\"age\":17},\"proof\":{\"created\":\"2023-11-30T05:19:40+08:00\",\"creator\":\"did:tdid:w1:0x379106c7232aed1a50e8600511655b479c76b149#keys-0\",\"signatureValue\":\"MEQCIEWnreXh0siSPnCaAqCldL1E+gTdrT6oSZjbTjAhwn6+AiBXn/ZIirpr69JknKsX3+MWRE7WeIXGdaOIXY10c36hoA==\",\"type\":\"Secp256r1\",\"metaDigest\":\"7d6435235cd5afdb7abd06a979eb2237d103401bdb54fa38ff6b8299c7529b76\",\"vcDigest\":\"d014b006648f48e13c1aff9c16a39979e3d17e6f32c816065158d6a92632a132\",\"privacy\":\"Public\",\"salt\":{\"action\":\"YuzFn\",\"age\":\"0zche\"}}}"
}
],
"Did": "did:tdid:w1:0xc1f030ceeb858887f0cc400030d59534cf8098c8",
"VerifyCode": "test",
"PolicyJson": "{\"1\":{\"age\":0}}"
}输出示例
{
"Response": {
"PresentationData": "{\"context\":[\"https://github.com/TencentCloud-Blockchain/TDID/blob/main/context/v1\"],\"holder\":\"did:tdid:c2:0x379106c7232aed1a50e8600511655b479c76b149\",\"proof\":{\"created\":\"2024-01-08T15:17:00+08:00\",\"nonce\":\"test\",\"signatureValue\":\"eyJjb250ZXh0IjpbImh0dHBzOi8vZ2l0aHViLmNvbS9UZW5jZW50Q2xvdWQtQmxvY2tjaGFpbi9URElEL2Jsb2IvbWFpbi9jb250ZXh0L3YxIl0sImhvbGRlciI6ImRpZDp0ZGlkOmMyOjB4Mzc5MTA2YzcyMzJhZWQxYTUwZTg2MDA1MTE2NTViNDc5Yzc2YjE0OSIsInR5cGUiOlsiVmVyaWZpYWJsZVByZXNlbnRhdGlvbiJdLCJ2ZXJpZmlhYmxlQ3JlZGVudGlhbCI6W3siY29udGV4dCI6Imh0dHBzOi8vZ2l0aHViLmNvbS9UZW5jZW50Q2xvdWQtQmxvY2tjaGFpbi9URElEL2Jsb2IvbWFpbi9jb250ZXh0L3YxIiwiY3B0SWQiOjEsImNyZWRlbnRpYWxTdWJqZWN0Ijp7ImFjdGlvbiI6ImRlYWN0aXZlRGlkIiwiYWdlIjoiMHg5NzUwNWE0ODY0NzM0NzBlNTBkMTM3MzIzMTM3ZGE4NTE3M2Y5OGU4MzQ0MGEzYjhjMWE3M2Q2ZDI0YWRiNmZlIn0sImV4cGlyYXRpb25EYXRlIjoiMjEyNC0wNi0yOVQxNToyNTowMCswODowMCIsImlkIjoiOGNmZTc1ZjFlMjlkOTk4ZWRhZGI5NjFlMTQxMDEyOWUiLCJpc3N1YW5jZURhdGUiOiIyMDI0LTAxLTA4VDEwOjM3OjU0KzA4OjAwIiwiaXNzdWVyIjoiZGlkOnRkaWQ6YzI6MHgzNzkxMDZjNzIzMmFlZDFhNTBlODYwMDUxMTY1NWI0NzljNzZiMTQ5IiwicHJvb2YiOnsiY3JlYXRlZCI6IjIwMjQtMDEtMDhUMTA6Mzc6NTQrMDg6MDAiLCJjcmVhdG9yIjoiZGlkOnRkaWQ6YzI6MHgzNzkxMDZjNzIzMmFlZDFhNTBlODYwMDUxMTY1NWI0NzljNzZiMTQ5I2tleXMtMCIsIm1ldGFEaWdlc3QiOiJiNGE2ODVjMzQ0ZGViMjg1Y2IwMTFiYzhiNmI3Mjg3NzhmYmU0NmNhOWZhYTE4OGNlYTZkYmM5YzM2ZDNiZDFiIiwicHJpdmFjeSI6IlB1YmxpYyIsInNhbHQiOnsiYWN0aW9uIjoieDZQMG4iLCJhZ2UiOiIwIn0sInNpZ25hdHVyZVZhbHVlIjoiTUVVQ0lFWEJkd2tHRi85UXpkdDRPRzlHS2cyRUJEb1hFOTAySGNFdlVndXMvbTZ3QWlFQW1NU3lRS0F1SUZvYmI4cTNDWkJTRmdBczhZL09WdEMwNTN0VVJTRk5SREk9IiwidHlwZSI6IlNlY3AyNTZyMSIsInZjRGlnZXN0IjoiMmRkNWExZGMzMjQ2ODZjOTNhNWIxNTgyMDZkNWZlOGI5MzdhMWZlNjQ3NjA5ODNkNWY1OWIyMzcxY2RlYjA5NSJ9LCJ0eXBlIjpbIlZlcmlmaWFibGVDcmVkZW50aWFsIl19XX0=\",\"type\":\"Secp256r1\",\"verificationMethod\":\"did:tdid:c2:0x379106c7232aed1a50e8600511655b479c76b149#keys-0\",\"vpDigest\":\"6728c750e86b1b793878c2a281bbebbe8d08b06a9266c1588ef841c6b3768475\"},\"type\":[\"VerifiablePresentation\"],\"verifiableCredential\":[{\"context\":\"https://github.com/TencentCloud-Blockchain/TDID/blob/main/context/v1\",\"cptId\":1,\"credentialSubject\":{\"action\":\"deactiveDid\",\"age\":\"0x97505a486473470e50d137323137da85173f98e83440a3b8c1a73d6d24adb6fe\"},\"expirationDate\":\"2124-06-29T15:25:00+08:00\",\"id\":\"8cfe75f1e29d998edadb961e1410129e\",\"issuanceDate\":\"2024-01-08T10:37:54+08:00\",\"issuer\":\"did:tdid:c2:0x379106c7232aed1a50e8600511655b479c76b149\",\"proof\":{\"created\":\"2024-01-08T10:37:54+08:00\",\"creator\":\"did:tdid:c2:0x379106c7232aed1a50e8600511655b479c76b149#keys-0\",\"metaDigest\":\"b4a685c344deb285cb011bc8b6b728778fbe46ca9faa188cea6dbc9c36d3bd1b\",\"privacy\":\"Public\",\"salt\":{\"action\":\"x6P0n\",\"age\":\"0\"},\"signatureValue\":\"MEUCIEXBdwkGF/9Qzdt4OG9GKg2EBDoXE902HcEvUgus/m6wAiEAmMSyQKAuIFobb8q3CZBSFgAs8Y/OVtC053tURSFNRDI=\",\"type\":\"Secp256r1\",\"vcDigest\":\"2dd5a1dc324686c93a5b158206d5fe8b937a1fe64760983d5f59b2371cdeb095\"},\"type\":[\"VerifiableCredential\"]}]}",
"RequestId": "52163044-3cd1-4ca9-8963-a36ac5554364"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| Cam.InvalidAuth | CAM鉴权失败 |
| Credential.CPTNotExisted | 凭证模板不存在 |
| Credential.CredentialExpired | 凭证过期:<%ExtMsg%> |
| Credential.FailedCreatePresentation | 创建凭证表达失败 |
| Credential.GenerateCommitmentFailed | 生成证明承诺失败 |
| Credential.GenerateRangeProof | 生成范围证明失败 |
| Credential.HolderDidNotMatch | 凭证持有人DID不匹配，请确认后重新操作:<%ExtMsg%> |
| Credential.InvalidCRDLId | 无效的凭证ID，请确认后重新操作:<%ExtMsg%> |
| Credential.InvalidCRDLIssuer | 无效的凭证颁发者，请确认后重新操作 |
| Credential.InvalidClaim | 无效的凭证声明，请确认声明格式:<%ExtMsg%> |
| Credential.InvalidDisclosurePolicy | 无效的选择性披露策略，请确认后重新操作:<%ExtMsg%> |
| Credential.InvalidOperateClaim | 无效的操作类型声明，请确认后重新操作:<%ExtMsg%> |
| Credential.InvalidParas | 无效请求参数，请确认参数格式:<%ExtMsg%> |
| Credential.InvalidProofCommitment | 无效的证明承诺 |
| Credential.InvalidProofValue | 无效的证明值，证明值要求是无符号整形 |
| Credential.InvalidZeroProof | 无效的零知识证明内容 |
| Credential.IssuerDidNotMatch | 凭证颁发者DID不匹配，请确认后重新操作:<%ExtMsg%> |
| Credential.NoIdInClaim | 凭证声明缺少ID字段，请确认后重新操作 |
| Credential.ProofValueNotExisted | 证明数值不存在 |
| Credential.VerifyCRDLFailed | 凭证验证失败:<%ExtMsg%> |
| Credential.VerifyZeroProofFailed | 零知识证明验证失败 |
| DataBase.FailedOperation | 数据库操作失败，请重新操作 |
| Did.PermissionDenied | 您无操作权限 |
| DidFailedOperation.DidNotExisted | DID标识不存在:<%ExtMsg%> |
| DidFailedOperation.DidSvcNotExisted | 用户尚未创建DID服务，请确认后重新操作 |
| DidSdk.UnknownError | DID服务请求错误，请稍后重试或联系客服 |
| FailedOperation.InvalidAuth | 用户接口鉴权失败 |
| FailedOperation.InvalidParameterValue | 无效的请求参数 |
| FailedOperation.OperationException | 操作失败。 |
| FailedOperation.PermissionDenied | 用户无接口访问权限 |
| HttpInvoker.NewQuestError | HTTP请求创建失败，请稍后重试，或联系客服 |
| HttpInvoker.SendQuestError | HTTP请求发送失败，请稍后重试，或联系客服 |
| InternalError.ApiUnknownError | API服务出错 |
| InternalError.ServiceDisabled | 服务已停止，请您检查当前是否有计费套餐包 |
| InternalError.ServiceError | 服务错误，请稍后重试，或联系客服 |
| InternalError.UnknownError | 服务错误，请稍后重试，或联系客服 |
| InvalidParameterValue.IllegalDateTime | 无效的时间格式，请确认后重新操作 |
| InvalidParameterValue.IllegalValue | 请求参数格式错误，请按照格式要求重新填写 |
| InvalidParameterValue.ResourceNotExisted | 用户请求资源未存在:<%ExtMsg%> |