接口盒子 API Skill

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

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

---

🚀 快速开始

1. 获取认证信息

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

注册后在用户后台获取：

• 开发者 ID (数字)
• 通讯 Key (字符串)

2. 配置认证

运行初始化向导：

node skills/apihz/scripts/init-wizard.js

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

动态密钥 (推荐):

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

3. 开始使用

自动同步 API 列表:

node skills/apihz/scripts/init-wizard.js

首次配置后自动执行:

1. ✅ 验证账号
2. ✅ 获取 41 个 API 分类
3. ✅ 遍历所有分类，获取全部 API 接口
4. ✅ 缓存到 skills/apihz/cache/apis.json

交互式调用 (推荐):

node skills/apihz/scripts/call-api.js

交互式调用流程:

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

代码调用:

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 任务，需要手动配置

自动签到脚本:

# 添加到 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)

🔧 高级配置

环境变量

# 自定义工作区路径 (可选)
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):

# 域名接口
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) 配置

第一步：设置预留信息

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

第二步：代码配置

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 参数调用接口

第三步：手动配置凭证文件

# 编辑 .credentials/apihz.txt
APIHZ_ID=你的 ID
APIHZ_KEY=你的 KEY
APIHZ_DMSG=your_secret_message  # 预留信息

代码配置示例

// 基础配置 (不使用动态密钥)
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. 凭证存储:

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

2. 动态密钥 (推荐):

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

3. 接口线路选择:

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

4. 网络传输:

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

5. 最佳实践:

   • ✅ 使用低权限测试账号，不要使用高价值凭证
   • ✅ 在生产环境使用隔离的工作区
   • ✅ 定期更新 KEY 和 DMSG

6. 签名脚本:

   • ⚠️ 技能本身不自动创建系统 cron 任务
   • ✅ 需要手动配置 crontab 来实现每日自动签到

技术提示

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

推荐配置 (生产环境)

# 强制使用 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