1. 接口描述
接口请求域名: kms.tencentcloudapi.com 。
使用后量子密码算法签名验签密钥进行签名。
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:PostQuantumCryptoSign。 |
Version | 是 | String | 公共参数,本接口取值:2019-01-18。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
Message | 是 | String | Base64 编码的消息原文。消息原文的长度(Base64编码前的长度)不超过4096字节。 示例值:dGVzdAo= |
KeyId | 是 | String | 密钥的唯一标识 示例值:b2b90f78-df57-11ed-979b-525400cf6ac4 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
Signature | String | 签名值,Base64编码。可使用 PostQuantumCryptoVerify接口对签名值进行验证。 示例值:MEUCICr/JCV52BqGvI0iYxdZ1eL8zzJjx39mWNv2ZWdLOMvRAiEApO6os3Wj0Tg3 |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 后量子密码算法签名
后量子密码算法签名。
输入示例
POST / HTTP/1.1
Host: kms.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: PostQuantumCryptoSign
<公共请求参数>
{
"Message": "dGVzdAo=",
"KeyId": "b2b90f78-df57-11ed-979b-525400cf6ac4"
}
输出示例
{
"Response": {
"RequestId": "5a3e2a73-73c3-480c-9e32-36a263803eec",
"Signature": "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"
}
}
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. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
AuthFailure | CAM签名/鉴权错误。 |
InternalError | 内部错误。 |
InvalidParameter | 参数错误。 |
InvalidParameterValue.InvalidKeyId | KeyId不合法。 |
MissingParameter | 缺少参数错误。 |
ResourceUnavailable.CmkNotFound | CMK不存在。 |
ResourceUnavailable.CmkStateNotSupport | CMK 状态不支持该操作。 |