接入开发规范

请求约定#

• 协议：HTTPS
• 方法：除特别说明外均为 POST
• Body：Content-Type: application/json
• 路径前缀：/finder/v2/api/...，Base URL：https://wx.chuapi.com

鉴权约定#

设备 ID（appId）约定#

• appId 是节点 / 设备唯一标识，绝大多数业务接口必填。
• 首次登录可传空以创建设备；掉线重登、日常调用必须使用返回的同一 appId。
• 同一微信号避免重复大量创建设备，否则易触发官方风控。

代理约定#

1. 平台共享代理：仅建议临时测试。
2. 自购 SOCKS5：socks5://username:password@host:port，建议长效住宅 / 归属地匹配。
3. AID 本地网络：模拟本机环境，需 24 小时在线；可下载 AID 程序或使用 AID 盒子。

响应约定#

{
"ret": 200,
"msg": "ok",
"data": {}
}

• ret = 200：业务侧通常表示成功（仍请结合 msg / data 判断）。
• 非 200：以 msg 为准排查鉴权、参数、节点在线状态与风控限制。

开发建议#

• 先跑通：登录 → 在线检测 → 发文本给文件传输助手 → 再接回调。
• 消息发送使用单线程队列，控制频率与随机间隔，禁止无间隔多线程狂发。
• 媒体发送优先「上传一次拿 XML / CDN，多账号复用」，避免重复上传。
• 业务 Webhook 必须快速响应，耗时逻辑异步化，防止回调超时丢消息。
• 账号稳定性与频率红线见「运维与风控规范」；接口字段以「API模块」正文为准。