加解密与编码工具

接口标识: cryptotool 价格: 0.008 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

加解密与编码工具接口把常用密码学能力收进一个入口：摘要计算支持 MD5、SHA1、SHA256、SHA512 与国密 SM3，对称加解密支持 AES-256-CBC 与国密 SM4，非对称支持 RSA-2048，另内置 Base64 与 URL 编解码。单次处理文本最大 1MB，摘要与对称结果可选十六进制或 Base64 输出。适合报文完整性校验、敏感字段加密存储、国密合规改造与开发联调自测。

详细介绍

![加解密与编码工具接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_cryptotool__1794363320_4dcb54e732fb.png)

摘要计算、加解密与编码转换是开发运维的高频基础操作，逐个搭环境既费时又容易出错。加解密与编码工具接口把这些能力收进一个调用入口。

## 接口概述
面向报文完整性校验、敏感字段加密存储、国密合规改造与开发联调等场景，传入操作类型（哈希、加密、解密、编码、解码）、算法名与待处理文本，接口同步完成计算并返回结果、所用算法与密钥或摘要长度。摘要支持 MD5、SHA1、SHA256、SHA512 与国密 SM3；对称加解密支持 AES-256-CBC 与国密 SM4；非对称支持 RSA-2048；另内置 Base64 与 URL 编解码。单次处理文本最大 1MB，结果编码可在十六进制与 Base64 之间选择。

## 核心能力
1. **五种操作**：hash、encrypt、decrypt、encode、decode，一个参数切换。
2. **十种算法**：MD5、SHA1、SHA256、SHA512、SM3、AES-256-CBC、SM4、RSA-2048、BASE64、URL 一站覆盖。
3. **国密就绪**：SM3 摘要与 SM4 对称加解密均已支持，适配国密合规改造。
4. **编码可选**：摘要与对称加密结果可按十六进制或 Base64 输出，解密按同一编码自动解析。
5. **规范实现**：AES 与 SM4 采用 CBC 模式与 PKCS7 填充，RSA 采用 OAEP-SHA256 填充，与主流实现互通。

## 产品优势
1. **一站调用**：一套参数覆盖摘要、对称、非对称与编码，无需引入多个工具库。
2. **接入简单**：单次 POST 传操作、算法与内容即得结果，联调即插即用。
3. **响应迅速**：纯本地计算，毫秒级同步返回。
4. **准确规范**：算法遵循行业标准实现，跨语言跨系统结果互认。
5. **稳定可靠**：无第三方依赖，批量计算不受外部服务波动影响。

## 效果展示
一句话理解：它就像一把密码学「多功能工具钳」，你说出算法名、递上文本，它转一下就把结果递回来。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| action | hash | 操作类型：hash/encrypt/decrypt/encode/decode |
| algorithm | SHA256 | 算法名，哈希可选 MD5、SHA1、SHA256、SHA512、SM3 |
| content | hello | 待处理文本，最大 1MB |
| output_encoding | hex | 结果编码，hex 或 base64，默认 hex |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 处理结果 | 2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824 | `result`，SHA256 摘要的十六进制形式 |
| 所用算法 | SHA256 | `algorithm` |
| 摘要长度 | 32 | `key_length`，摘要或密钥的字节数，编码操作时为 null |

API请求示例：

```text
POST /api/cryptotool
action=hash&algorithm=SHA256&content=hello&output_encoding=hex
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "result": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
    "algorithm": "SHA256",
    "key_length": 32
  },
  "request_id": "crypto-demo-sha256-0001"
}
```

把 action 换成 encrypt、algorithm 换成 AES-256-CBC 并传入 key 与 iv，即变为对称加密调用；每次响应都回显算法与长度，便于核对参数是否生效。

## 应用场景
1. **完整性校验**：为文件与报文计算摘要，核对内容在传输中是否被篡改。
2. **敏感字段加密**：手机号、证件号等字段以 AES 或 SM4 加密入库，使用时解密还原。
3. **国密改造**：合规项目用 SM3、SM4 平滑替换原有摘要与国际对称算法。
4. **开发联调**：接口签名与加密方案联调时，双方用同一入口核对摘要与密文。
5. **参数编码**：Base64 与 URL 编解码处理链接参数传递与还原。

## 应用案例
一家 SaaS 厂商与客户联调报文签名时，双方各自本地计算摘要经常对不上，排查一次要半天；接入接口后双方以同一入口取 SHA256 结果做基准，签名不一致问题当场即可定位。

一个会员系统按安全要求把库内明文手机号改造为国密 SM4 加密存储；开发用接口完成存量数据批量加密与回写，再抽样解密比对一致，改造按期通过安全验收。

一支前端团队需要在链接中传递中文参数，自写编码对加号与百分号的处理不兼容，导致参数偶发丢失；改用接口的 URL 编解码成对调用后，参数传递再未出错。

常见问题

Q：AES 和 SM4 的密钥、IV 应该传什么格式？

A：均为十六进制字符串：AES-256-CBC 的 key 为 32 字节（64 个十六进制字符），SM4 的 key 为 16 字节（32 个十六进制字符），两者的 iv 都是 16 字节（32 个十六进制字符）。格式或长度不符会返回参数错误（code=40002）。

Q：RSA 加解密的密文是什么编码？

A：RSA-2048 采用 OAEP-SHA256 填充，加密结果固定为 Base64 字符串，解密时也按 Base64 传入密文。RSA 单次仅适合较短文本，长内容建议用对称算法加密后再用 RSA 传递密钥。

Q：支持国密 SM2 吗？

A：当前支持 SM3 摘要与 SM4 对称加解密，SM2 非对称算法暂不支持，传入 SM2 会返回参数错误提示。

Q：key_length 返回的是什么？

A：哈希操作返回摘要的字节数（如 SHA256 为 32），对称加解密返回密钥字节数（AES 为 32、SM4 为 16），RSA 返回 2048，Base64 与 URL 编解码操作返回 null。

加密解密哈希 MD5 SHA256 AES 国密 Base64

接口地址： https://www.phpwc.cn/api/cryptotool

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`action`	string	必填	-	操作：encrypt/decrypt/hash/encode/decode
`algorithm`	string	必填	-	算法：AES-256-CBC/RSA-2048/SM4/MD5/SHA1/SHA256/SHA512/SM3/BASE64/URL
`content`	string	必填	-	待处理文本，≤1MB
`key`	string	选填	-	对称密钥（AES 32字节/SM4 16字节十六进制）或 RSA PEM 公私钥
`iv`	string	选填	-	AES/SM4 初始向量（16 字节十六进制）
`output_encoding`	string	选填	`hex`	加解密/hash 输出编码：hex/base64，默认 hex

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`result`	string	处理结果
`algorithm`	string	所用算法
`key_length`	int	密钥或摘要字节长度
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试