Hash摘要计算
用于计算常见摘要值,适合接口调试、签名比对和文本校验。支持 `md5`、`sha1`、`sha256`、`sha512`。
GET/POSTJSON已发布版本 1.0
快速接入
QUICK START- 01查看参数说明选择请求方式与取值
- 02查看实际响应
- 03复制代码开始接入按你的开发语言选择
示例请求
每个 IP 每分钟 120 次;图片接口可能另有较低额度。限流时请按 Retry-After 等待。
请求参数
| 参数 | 类型 / 必填 | 示例 / 默认 | 说明 / 取值 |
|---|---|---|---|
algo | string | sha256默认:sha256 | 默认 `sha256`;可选 `md5`、`sha1`、`sha256`、`sha512` | 摘要算法名称。传入其他算法会返回 `400`。 取值:md5,sha1,sha256,sha512 |
text | string | abc默认:无 | 默认空字符串 | 要计算摘要的原始文本,允许为空。 |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
algo | string | 实际使用的摘要算法。 |
input | string | 原始输入文本。 |
input_length | integer | 输入内容长度,按 PHP `strlen` 计算,中文等多字节字符会按字节统计。 |
hash | string | 计算得到的十六进制摘要字符串。 |
返回示例
## 成功响应示例
```json
{
"algo": "sha256",
"input": "abc",
"input_length": 3,
"hash": "ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad"
}
```
## 错误响应示例
```json
{
"error": "Invalid algo. Allowed values: md5, sha1, sha256, sha512"
}
```错误说明
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数无效 |
| 405 | 请求方法不支持 |
| 413 | 请求内容过大 |
| 429 | 请求过于频繁 |
| 502 | 上游服务不可用 |
| 503 | 接口维护中 |
400:检查参数;429:按 Retry-After 等待;503:维护中;502:上游暂不可用,可稍后重试或反馈。
响应结果
RESPONSE点击发送请求后查看响应。
接入代码
INTEGRATION代码根据当前请求方式和参数生成。先到在线调试填入参数,再复制到自己的程序。
站长补充的 PHP 示例
<?php
$url = 'https://api.keguan.org.cn/api/hash/?algo=sha256&text=abc';
$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 5, CURLOPT_TIMEOUT => 30, CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
if ($response === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
if ($status >= 400) { throw new RuntimeException('HTTP ' . $status . ': ' . $response); }
header('Content-Type: ' . ($contentType ?: 'application/octet-stream'));
echo $response;