apihz-cn

# 接口盒子 API Skill

> 409+ 企业级 API 接口 - 稳定、高效、易用

版本: v1.0.8 状态: ✅ 生产就绪 更新: 官方接口线路优化 (域名/IP/VIP 三线容错)

---

🚀 快速开始

1. 获取认证信息

访问：https://www.apihz.cn/?shareid=10013679

• 注册后在用户后台获取：
• 开发者 ID (数字)
• 通讯 Key (字符串)

2. 配置认证

运行初始化向导： ```bash node skills/apihz/scripts/init-wizard.js ```

按提示填入 ID、KEY 和预留信息，自动验证并配置动态密钥。

• 动态密钥 (推荐):
• 开启动态密钥后，每次调用接口需验证 `dkey` 参数
• `dkey = md5(预留信息 + 动态参数)`
• 动态参数通过【动态参数获取】接口获取，有效期 10 秒

3. 开始使用

自动同步 API 列表: ```bash node skills/apihz/scripts/init-wizard.js ```

1. 首次配置后自动执行:
2. ✅ 验证账号
3. ✅ 获取 41 个 API 分类
4. ✅ 遍历所有分类，获取全部 API 接口
5. ✅ 缓存到 `skills/apihz/cache/apis.json`

交互式调用 (推荐): ```bash node skills/apihz/scripts/call-api.js ```

1. 交互式调用流程:
2. 自动加载配置和 API 缓存
3. 选择 API 分类 (41 个分类可选)
4. 选择具体 API 接口
5. 按提示输入参数
6. 查看调用结果

代码调用: ```javascript const { ApiHzClient } = require('./skills/apihz/src/client-enhanced.js');

const client = new ApiHzClient({ id: '你的 ID', key: '你的 KEY', baseUrl: 'https://cn.apihz.cn' });

// 调用任意 API const result = await client.request('/api/ajax/ajax.php', { type: '6', // Ping 测试 words1: 'qq.com' }); ```

---

📦 核心 API (免费示例)

| API | 说明 | 调用方法 | |-----|------|---------| | 时间戳 | 北京时间 | `client.timestamp()` | | Ping 测试 | 网络延迟测试 | `client.ping('qq.com')` | | ICP 备案 | 企业备案查询 | `client.icp('baidu.com')` | | IP 归属地 | 全球 IP 定位 | `client.ipLocation('8.8.8.8')` | | 地震数据 | 最新地震数据 | `client.earthquake()` | | 翻译服务 | 多语言翻译 | `client.translate('hello', 'en', 'zh')` | | 临时邮箱 | 创建临时邮箱 | `client.tempEmailCreate()` | | 汇率查询 | 货币汇率 | `client.exchangeRate()` |

完整 API 列表: 运行 `init-wizard.js` 自动同步后查看 `cache/apis.json`

---

💎 会员说明

| 等级 | 价格 | 频次 | 推荐 | |------|------|------|------| | 注册 | 免费 | 10/分钟 | ⭐ 个人 | | 彩钻 | ¥30/月 | 310/分钟 | ⭐⭐ 企业 | | 炫钻 | ¥50/月 | 1010/分钟 | ⭐⭐⭐ 大型 |

彩钻特权: 专属集群、VIP 线路、CDN 加速、智能故障切换

---

🎰 每日签到

手动配置: 技能本身不自动创建系统 cron 任务，需要手动配置

自动签到脚本: ```bash # 添加到 crontab (每天 00:02 执行) crontab -e

# 添加以下行 (替换路径) 2 0 * * * OPENCLAW_WORKSPACE=/your/path node /your/path/skills/apihz/scripts/auto-checkin.js ```

奖励: 抽奖形式 (1-5 盟点/会员天数)

• 奖项:
• 五等奖：1-5 盟点 (高概率)
• 四等奖：1 天钻石会员
• 三等奖：7 天钻石会员
• 二等奖：30 天钻石会员
• 一等奖：扩展频次 +5 (永久)

---

📁 文件结构

``` skills/apihz/ ├── SKILL.md # 本文件 ├── src/ │ ├── client.js # 基础客户端 │ ├── client-enhanced.js # 增强客户端 (支持 HTML 解析) │ └── auth.js # 认证管理 (带故障切换) ├── scripts/ │ ├── init-wizard.js # 初始化向导 │ ├── auto-checkin.js # 自动签到 │ └── call-api.js # 交互式调用 └── .credentials/ └── apihz.txt # 认证信息 (gitignore) ```

🔧 高级配置

环境变量

```bash # 自定义工作区路径 (可选) export OPENCLAW_WORKSPACE=/your/custom/path

# 自定义 API 列表节点 (可选，默认官方 CDN) export APIHZ_LIST_URL=http://your-preferred-node/api/xitong/apilist.php

# 主 API 域名 (可选) # 域名接口：https://cn.apihz.cn (默认，自动分发) # VIP 线路：https://vip.apihz.cn (超高稳定，需购买) export APIHZ_BASE_URL=https://cn.apihz.cn

# 动态密钥预留信息 (可选，开启后增强安全性) export APIHZ_DMSG=your_secret_message ```

接口线路说明 (适用于所有 API)

官方说明: https://www.apihz.cn/template/miuu/getpost.php

> 💡 说明: 所有 409+ 个 API 接口均支持以下三种线路类型，调用格式相同，仅域名/IP 不同。

| 线路类型 | 地址示例 | 特点 | 推荐 | |---------|---------|------|------| | 域名接口 | `https://cn.apihz.cn/api/...` | 自动分发，CC 防火墙适中 | ⭐⭐⭐ 默认 | | 集群 IP | `http://101.35.2.25/api/...` | 速度快，CC 防火墙严格 | ⭐⭐ 备用 | | VIP 线路 | `https://vip.apihz.cn/api/...` | 超高稳定，CC 防火墙宽松 | ⭐⭐⭐⭐ 企业 |

获取最优 IP: 访问 `https://api.apihz.cn/getapi.php` 获取当前最优 IP 地址

示例 (天气 API): ```bash # 域名接口 GET https://cn.apihz.cn/api/tianqi/tqyb.php?id=你的 ID&key=你的 KEY&sheng=安徽&place=芜湖

# 集群 IP 接口 GET http://101.35.2.25/api/tianqi/tqyb.php?id=你的 ID&key=你的 KEY&sheng=安徽&place=芜湖

# VIP 线路 GET https://vip.apihz.cn/api/tianqi/tqyb.php?id=你的 ID&key=你的 KEY&sheng=安徽&place=芜湖 ```

动态密钥 (dkey) 配置

第一步：设置预留信息 ```bash # 在用户后台设置预留信息参数，开启动态密钥开关 # 然后配置到环境变量或凭证文件 export APIHZ_DMSG=your_secret_message ```

第二步：代码配置 ```javascript const client = new ApiHzClient({ id: '你的 ID', key: '你的 KEY', dmsg: 'your_secret_message', // 预留信息 baseUrl: 'https://cn.apihz.cn', timeout: 10000, retryCount: 2 });

// 客户端会自动处理 dkey 生成 // 每次调用接口时： // 1. 获取动态参数 dcan (有效期 10 秒) // 2. 生成 dkey = md5(dmsg + dcan) // 3. 附带 dkey 参数调用接口 ```

第三步：手动配置凭证文件 ```bash # 编辑 .credentials/apihz.txt APIHZ_ID=你的 ID APIHZ_KEY=你的 KEY APIHZ_DMSG=your_secret_message # 预留信息 ```

代码配置示例

```javascript // 基础配置 (不使用动态密钥) const client = new ApiHzClient({ id: '123456', key: 'abcdef', baseUrl: 'https://cn.apihz.cn' });

// 增强配置 (使用动态密钥) const client = new ApiHzClient({ id: '123456', key: 'abcdef', dmsg: 'my_secret_2026', baseUrl: 'https://cn.apihz.cn' }); ```

---

⚠️ 注意事项

安全提示

1. 凭证存储:
2. - ✅ KEY 和 DMSG 使用 AES-256-GCM 加密存储
3. - ✅ 加密密钥基于机器指纹生成 (主机名 + 用户名 + 工作区)
4. - ✅ 不要将凭证文件复制到其他机器使用
5. - ✅ 不要将该文件提交到 Git

1. 动态密钥 (推荐):
2. - ✅ 开启动态密钥后，每次调用需验证 `dkey` 参数
3. - ✅ `dkey = md5(预留信息 + 动态参数)`，防止被抓包
4. - ✅ 动态参数有效期 10 秒，仅能使用 1 次
5. - ✅ 配置 `APIHZ_DMSG` 环境变量或凭证文件

1. 接口线路选择:
2. - 🟢 域名接口 (默认): `https://cn.apihz.cn` - 自动分发，CC 防火墙适中
3. - 🟢 集群 IP: `http://101.35.2.25` 等 - 速度快，CC 防火墙严格，定期更新
4. - 🟡 VIP 线路: `https://vip.apihz.cn` - 超高稳定，CC 防火墙宽松 (需购买)
5. - 📖 获取最优 IP: 访问 `https://api.apihz.cn/getapi.php` 获取当前最优 IP

1. 网络传输:
2. - ✅ 主 API 使用 HTTPS 加密 (`https://cn.apihz.cn`)
3. - ⚠️ API 列表查询可能回退到 HTTP 备用节点 (仅查询，不传输凭证)
4. - ✅ 可通过 `APIHZ_BASE_URL` 强制使用 HTTPS

1. 最佳实践:
2. - ✅ 使用低权限测试账号，不要使用高价值凭证
3. - ✅ 在生产环境使用隔离的工作区
4. - ✅ 定期更新 KEY 和 DMSG

1. 签名脚本:
2. - ⚠️ 技能本身不自动创建系统 cron 任务
3. - ✅ 需要手动配置 crontab 来实现每日自动签到

技术提示

1. 参数编码: 每个参数独立编码，不要合并
2. 请求方式:
3. - ✅ 推荐 POST (适合大参数)
4. - ✅ GET 用于简单查询
5. - 📖 官方教程：https://www.apihz.cn/template/miuu/getpost.php
6. 超时设置:
7. - 连接超时：10 秒
8. - 整体超时：30 秒
9. - 可通过 `timeout` 参数自定义
10. 服务器配置:
11. - 主 API: `https://cn.apihz.cn` (官方域名，HTTPS)
12. - API 列表：可通过 `APIHZ_LIST_URL` 环境变量指定 HTTPS 节点
13. - 故障切换：主服务器不可用时自动尝试备用节点
14. 路径配置:
15. - 默认工作区：`$HOME/.openclaw/workspace`
16. - 可通过 `OPENCLAW_WORKSPACE` 环境变量覆盖
17. - 凭证文件：`{workspace}/.credentials/apihz.txt`

推荐配置 (生产环境)

```bash # 强制使用 HTTPS export APIHZ_BASE_URL=https://cn.apihz.cn export APIHZ_LIST_URL=https://cn.apihz.cn/api/xitong/apilist.php

# 指定工作区 export OPENCLAW_WORKSPACE=/path/to/your/workspace ```

---

📞 支持

• 官网：https://www.apihz.cn
• QQ 群：500700444
• 客服 QQ: 2813858888

---

*最后更新：2026-03-08*