HTTP API 参考
iLink Hub 暴露两类 HTTP 端点：兼容 iLink 协议的客户端端点和 Hub 专属管理端点。
iLink 兼容端点
这些端点与真实的 ilinkai.weixin.qq.com 完全兼容，AI 客户端无需修改代码。
Base URL: http://your-hub.example.com:8765
认证: HTTP 头 Authorization: Bearer <虚拟 Token>
POST /ilink/bot/getupdates
长轮询，等待新消息。如 30 秒内无新消息则返回空结果。
请求体：
json
{
"token": "vhub_xxxxxxxx"
}响应（有消息时）：
json
{
"errcode": 0,
"messages": [
{
"context_token": "vhub_ctx_xxxxxxxx",
"from_user": "user_openid",
"content": "你好",
"msg_type": "text",
"timestamp": 1717545600
}
]
}POST /ilink/bot/sendmessage
发送回复消息给微信用户。
请求体：
json
{
"token": "vhub_xxxxxxxx",
"context_token": "vhub_ctx_xxxxxxxx",
"content": "你好！有什么可以帮你的？",
"msg_type": "text"
}响应：
json
{"errcode": 0}POST /ilink/bot/sendtyping
发送「正在输入」状态指示。
请求体：
json
{
"token": "vhub_xxxxxxxx",
"context_token": "vhub_ctx_xxxxxxxx"
}POST /ilink/bot/getconfig
获取输入配置（typing ticket）。
POST /ilink/bot/getuploadurl
获取媒体文件 CDN 上传地址。
Hub 管理端点
这些端点用于注册和管理客户端。
认证: 若设置了 ILINK_ADMIN_TOKEN，需要携带 Authorization: Bearer <admin-token>。
POST /hub/register
注册新客户端，获取虚拟 Token。
请求体：
json
{
"name": "mac-home",
"label": "Mac 本机 Recursive"
}响应：
json
{
"name": "mac-home",
"label": "Mac 本机 Recursive",
"token": "vhub_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"created_at": "2026-06-05T10:00:00Z"
}WARNING
token 字段只在此处返回一次明文，之后无法从 Hub 恢复。请务必保存。
GET /hub/clients
列出所有已注册的客户端。
响应：
json
{
"clients": [
{
"name": "mac-home",
"label": "Mac 本机 Recursive",
"status": "online",
"last_seen": "2026-06-05T10:01:30Z",
"queue_size": 0
},
{
"name": "openclaw-01",
"label": "OpenClaw 实例 1",
"status": "offline",
"last_seen": "2026-06-05T09:55:00Z",
"queue_size": 0
}
],
"total": 2,
"online": 1
}GET /hub/ui
Web 管理面板（浏览器界面）。返回 HTML 页面。
其他端点
GET /health
健康检查，可用于监控和负载均衡器探活。
响应（正常）：
json
{
"status": "ok",
"upstream": "connected",
"clients": {
"online": 2,
"total": 3
}
}响应（上游断开）：
json
{
"status": "degraded",
"upstream": "reconnecting",
"clients": {
"online": 2,
"total": 3
}
}HTTP 状态码：正常返回 200，降级状态也返回 200（便于区分完全故障）。
GET /metrics
Prometheus 格式的指标数据。
详见 Prometheus 指标。