哈希加密计算hash

哈希加密计算，支持 12 种主流算法，可一次性返回全部，也可指定单个算法。支持 HMAC 签名模式与 hex / base64 双输出编码，毫秒级返回。 • 通用摘要：MD5、SHA-1、SHA-256、SHA-384、SHA-512 • 现代抗碰撞：SHA3-256、SHA3-512、RIPEMD-160、Whirlpool • 校验和：CRC32、CRC32B、Adler-32 • HMAC 签名：传入 hmac_key 自动切换为 HMAC 模式（用于 API 签名 / 防篡改场景） • 输出编码：hex（默认，更可读）/ base64（节省 25% 字节，适合 URL 传输）纯本地计算，零外部上游依赖，毫秒级响应。HMAC 密钥仅参与计算，不写日志、不缓存、不回显。

1. 基本信息

接口地址	`https://v1.apizero.cn/api/hash`
请求方法	`GET`
分类	dev
提供方	极数本源
计费模式	免费试用
单次消耗	0 积分
起步价	—
QPS 限制	20 req/s
每日免费额度	1000 次（已认证用户）
匿名每日额度	200 次（无 API Key）
VIP 免费	否
调用次数

2. 认证

匿名每日 200 次、QPS 5；登录用户每日 1000 次、QPS 20（全部免费）。纯本地计算，无外部依赖，毫秒级响应。

获取 API Key：登录 https://apizero.cn/account/keys

3. 请求参数

参数名	类型	必填	说明	示例
`text`	`string`	是	要计算哈希的文本，UTF-8 编码，最长 10000 字节（中文 1 字 = 3 字节，约支持 3300 个中文）	`hello`
`algorithm`	`string`	否	算法标识，默认 all。支持：all / md5 / sha1 / sha256 / sha384 / sha512 / sha3-256 / sha3-512 / ripemd160 / whirlpool / crc32 / crc32b / adler32（自动兼容无连字符写法 sha3256）	`all`
`encoding`	`string`	否	输出编码：hex（默认，更可读）/ base64（节省 25% 字节）	`hex`
`hmac_key`	`string`	否	HMAC 密钥，传入则自动切换为 HMAC 模式生成签名；密钥仅参与计算，不写入任何日志或缓存	`mysecret`

4. 请求头

Header	类型	必填	说明	示例
`Authorization`	`string`	否	API Key 鉴权头，格式 Bearer sk_live_xxx；匿名调用时可省略（每日 200 次免费）	`Bearer sk_live_xxxxxxxxxxxxxx`

5. 请求示例 (cURL)

curl "https://v1.apizero.cn/api/hash?text=hello&algorithm=all&encoding=hex&hmac_key=mysecret&key=YOUR_API_KEY"

6. 响应字段

字段	类型	说明	示例
`text_length`	`number`	输入文本的字符数（按 UTF-8 字符计数）	—
`text_bytes`	`number`	输入文本的字节长度	—
`encoding`	`string`	输出编码：hex / base64	—
`hmac`	`boolean`	是否使用 HMAC 模式（hmac_key 非空时为 true）	—
`hash_count`	`number`	本次返回的哈希数量（all 时为 12，单算法时为 1）	—
`hashes`	`object`	哈希结果字典，key 为算法标识（如 md5、sha3-256）	—
`hashes.<algo>.algorithm`	`string`	算法显示名（如 MD5、SHA3-256）	—
`hashes.<algo>.bits`	`number`	哈希位数（如 128、256、512）	—
`hashes.<algo>.value`	`string`	哈希值（hex 或 base64 编码字符串）	—
`hashes.<algo>.length`	`number`	value 字符串长度（hex=bits/4, base64≈ceil(bits/6)）	—

7. 响应示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "text_length": 5,
        "text_bytes": 5,
        "encoding": "hex",
        "hmac": false,
        "hash_count": 3,
        "hashes": {
            "md5": {
                "algorithm": "MD5",
                "bits": 128,
                "value": "5d41402abc4b2a76b9719d911017c592",
                "length": 32
            },
            "sha1": {
                "algorithm": "SHA-1",
                "bits": 160,
                "value": "aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d",
                "length": 40
            },
            "sha256": {
                "algorithm": "SHA-256",
                "bits": 256,
                "value": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
                "length": 64
            }
        }
    },
    "request_id": "abc123def456"
}

8. 错误码

code	status	说明
`4000`	`—`	参数错误：text 为空 / 超长 / algorithm 不支持 / encoding 非 hex 或 base64
`4015`	`—`	匿名调用每日额度用完，需要 API Key
`4029`	`—`	QPS 超限
`4030`	`—`	今日额度用完
`5000`	`—`	服务器 PHP 不支持指定算法（极少出现，所有主流 PHP 7.1+ 默认全部支持）

9. 变更日志

1.0.0(2026-05-06)
- 首次上线，支持 12 种主流哈希算法 + HMAC + hex/base64 编码
- 纯本地计算（PHP 内置 hash() / hash_hmac()），毫秒级响应
- sha3-256 / sha3-512 自动兼容无连字符写法（sha3256）
- HMAC 密钥仅参与计算，不写日志、不缓存、不回显
- 响应额外返回 text_bytes 字段方便前端展示「字节数 vs 字符数」