CalculateDigest
更新时间：2023-03-07
CalculateDigest
- 接口描述
计算 SM3 摘要
- 请求URI
POST /?action=CalculateDigest请求体参数
- 请求体字段数据结构说明
| 参数 | 类型 | 是否必需 | 描述 | 示例值 |
|---|---|---|---|---|
| keyId | String | 是 | CMK的密钥Id | 5be45b47-38ba-f055-e892-25ff66c91adc |
| message | String | 是 | 需要计算摘要的消息,长度不超过4096，base64编码 | aGVsbG8lMEE= |
| algorithm | String | 是 | 杂凑算法，现在仅支持SM3 | SM3 |
| messageNum | Integer | 是 | 数据包编号 | 1 |
| messageSum | Integer | 是 | 数据包总数 | 1 |
| hashContextIn | String | 否 | 上一个数据包返回的hashContextIn | AAAAFJRggJgJP4GbuX74LiEE/zC7S08fRww5nYzKKUhnaNbIABEAAAAAAAA4OTE0NzYwNzYxNTA0NDEzMjkyMjU1Njc0MjI1NjQ0NTc0NzMwMDEyMzg0NzQ0MzYzMzkyNzQxOTc0MzkzNzEz |
响应体参数
- 响应体字段数据结构说明
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| keyId | String | CMK的密钥Id（SM2） | cf8a75a9-625d-0dfa-8a87-233f7c64c1cf |
| hashContextIn | String | 数据包的消息体，当数据包不是最后一个数据包时有值，其余为空字符串，base64编码 | |
| digest | 摘要，当不是最后一个数据包时为空字符串,base64编码 | datakey密文，base64编码 | 08kq//NUclP5LtZrhCBZ8Pv8Y0rNI2LZBAS5r0JZQv0= |
请求示例
POST /?action=CalculateDigest
<公共请求头>
{
"messageNum" : 1,
"keyId" : "cf8a75a9-625d-0dfa-8a87-233f7c64c1cf",
"hashContextIn" : "AAAAFJRggJgJP4GbuX74LiEE/zC7S08fRww5nYzKKUhnaNbIABEAAAAAAAA4OTE0NzYwNzYxNTA0NDEzMjkyMjU1Njc0MjI1NjQ0NTc0NzMwMDEyMzg0NzQ0MzYzMzkyNzQxOTc0MzkzNzEz",
"message" : "aGVsbG8lMEE=",
"messageSum" : 1,
"algorithm" : "SM3"
}响应示例
HTTP/1.1 200 OK
<公共响应头>
{
"digest" : "08kq//NUclP5LtZrhCBZ8Pv8Y0rNI2LZBAS5r0JZQv0=",
"keyId" : "cf8a75a9-625d-0dfa-8a87-233f7c64c1cf",
"hashContextIn" : "hashContextIn"
}