aes算法

接口说明

用于对字符串执行 AES 加解密运算，支持指定加密模式与密钥，适合需要在客户端与服务端之间做数据加密传输的开发者调用。接口免费开放，无需密钥即可使用。

调用地址

https://mini10.top/api/aes.php

请求方式

GET

鉴权说明

本接口无需密钥，无需在请求中携带任何鉴权信息，可直接调用。

请求参数

调用地址：https://mini10.top/api/aes.php，请求方式：GET。本接口无需密钥，免费调用。

参数取值说明：

• act：常用取值包括 aes-128-cbc、aes-192-cbc、aes-256-cbc 等，需与 key 长度相匹配，例如 aes-256-cbc 使用 32 字节密钥。
• type：仅接受 encrypt 与 decrypt 两个值；传入 decrypt 时，content 应为合法的密文串。
• iv：使用 CBC 等需要初始向量的模式时必须提供，使用 ECB 模式时可省略。
• 参数值中如含 +、/、= 等字符，需按 URL 编码规则转义后再传递。

成功响应示例

{
  "code": 0,
  "type": "encrypt",
  "act": "aes-256-cbc",
  "data": "CPnv7eGM8oJo4GvYbu3ySQ==",
  "key": "12345678901234567890123456789012",
  "iv": "1234567890123456"
}

响应字段说明

接口无需密钥，请求参数通过 URL 查询串传递，返回统一为 JSON 结构，code 为 0 即代表本次运算已完成。

错误响应示例

接口返回统一 JSON 结构，业务处理结果通过 code 与 errcode 字段表达。当请求未通过校验或处理失败时，code 为 0，msg 为对应错误说明，errcode 为具体业务错误码。

未提供调用密钥时：

{"code":0,"msg":"未提供调用密钥","errcode":11001}

密钥错误时：

{"code":0,"msg":"密钥错误","errcode":11002}

积分余额不足时：

{"code":0,"msg":"积分余额不足","errcode":11004}

请求参数缺失或接口维护中时：

{"code":0,"msg":"接口维护中","errcode":11006}

请求方式不符合要求时：

{"code":0,"msg":"请求方式不允许","errcode":11018}

接口不存在时：

{"code":0,"msg":"接口不存在","errcode":11013}

以上示例仅示意返回结构，实际 msg 内容以具体错误场景为准。出现错误时请优先根据 errcode 定位原因，再对照下表处理。

业务错误码说明

说明：本接口为免费接口且无需密钥，常规调用不会触发密钥与积分相关错误码；若出现上述错误码，请依据表格中对应含义进行排查。对于提示***地址、出口代理相关的错误码，属于服务侧配置问题，重试无效时请联系管理员。

调用示例

终端 curl（bash）

curl "https://mini10.top/api/aes.php?content=1&act=aes-256-cbc&key=12345678901234567890123456789012&iv=1234567890123456&type=encrypt"

PHP

// PHP 示例
$url = "https://mini10.top/api/aes.php";
$params = [
    "content" => "1",
    "act"     => "aes-256-cbc",
    "key"     => "12345678901234567890123456789012",
    "iv"      => "1234567890123456",
    "type"    => "encrypt",
];
$ch = curl_init($url . "?" . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

注意事项

• 密钥长度须与算法匹配：act 指定的是具体加密算法（如 aes-256-cbc），对应的 key 必须满足该算法的密钥长度要求（AES-256 需 32 字节，AES-128 需 16 字节），长度不符会导致加解密失败或返回异常结果。
• iv 的适用性随算法变化：CBC 等模式必须提供与块长（16 字节）一致的 iv；ECB 等模式不使用 iv，传入也不会生效。请根据 act 的实际模式决定是否填写，缺失必填 iv 时将无法正确加解密。
• type 仅接受明确取值：传入 encrypt 表示加密、decrypt 表示解密，其他取值不会被正确处理，调用前请核对拼写。
• content 与 type 需配套：解密时 content 应为加密所得的密文（通常为 Base64 形式），并确保 act、key、iv 与当初加密时完全一致，否则解密结果为空或乱码。
• 参数须做 URL 编码：本接口为 GET 请求，content 中的 +、/、= 等 Base64 字符以及 key、iv 中的特殊字符必须经 URL 编码后传递，否则会被截断或篡改，导致结果错误。
• 密钥不要在客户端暴露：本接口无需鉴权、调用免费，但 key 与 iv 属于敏感参数，请通过服务端发起调用；不要把密钥硬编码到前端页面、公开代码仓库或可被他人查看的请求日志中。
• 传输应使用 HTTPS：请始终以 https://mini10.top/api/aes.php 发起请求，避免密钥与明文数据在明文信道中泄露。
• 接口免费但不建议高频轮询：大批量加解密请在业务侧批量处理并做适当节流，避免短时间内产生大量请求影响可用性。
• 结果请校验 code：返回体中 code 为 0 表示处理成功，此时 data 为加密或解密结果；非 0 时应结合返回内容排查参数问题，不要直接使用 data 字段。