文档
简洁、可运行的实战手册。所有 SDK 调用示例都跑得通。
起步
SDK
- Go SDK Go 标准库零依赖薄客户端
- Python SDK Python 3.9+ urllib 零依赖薄客户端
- TypeScript SDK Node 18+ 全局 fetch 零运行时依赖薄客户端
协议
- Agent ↔ 中枢 协议 WebSocket subprotocol m2gw.agent.v1 + L1 兼容协议
进阶
- 主机级 L1 配置 每台主机独立的 {bid, secretKey, 反向上报 URL},三入口可改,软重启 1 秒生效
- Webhook 推送 配置变更主动 POST 到你的业务系统,HMAC-SHA256 签名,自动重试 + 死信
- 主机生命周期管理(Client API) 用 API Key 在自家业务系统里批量创建/删除主机、颁发安装凭据、直接下载 ps1/cmd/exe 安装包
发布动态
- m2-gateway agent 发布记录 agent 版本发布记录、修复内容、升级方式
📥 下载完整 API 文档
含 M7 系列全部新接口:主机级 L1 配置 / Webhook 推送 / Admin 终端 / 计费模式切换。
📄
OpenAPI 3.0 YAML 机器可读规范 · ~38 KB · 喂给 Swagger / Redoc / openapi-generator 📘
API.md 速查 人类可读 Markdown · ~20 KB · 含错误码 + 审计映射 🗜️
打包 ZIP openapi.yaml + API.md 一起下 · ~15 KB 在线浏览 / 自动生成 SDK
- Redoc — 美观的静态文档浏览器(粘贴上面的 yaml URL 即可)
- Swagger UI — 可交互文档 + 在线 try
- openapi-generator — 自动生成 PHP / Java / Ruby 等 SDK