小程序助手 API Reference

接口说明按真实调用链整理。

登录后可通过 Cookie 调用；脚本调用推荐使用 X-Auth-Token。扫码来源支持「应用宝」和「手游助手」，账号入库后即可用于获取 code。

认证 Cookie / Token默认平台 应用宝新增平台 手游助手格式 JSON

调用流程

从登录到获取 code 的完整链路。

1. 登录控制台调用 /api/auth/login 获取 token，或直接使用浏览器 Cookie。
2. 扫码保存账号/api/qr/start 选择 source，/api/qr/status 轮询到 confirmed。
3. 调用业务接口使用账号 ref + app_id 获取 code，或生成启动参数。

接口列表

表格已按使用频率排序，方法、路径、参数和认证要求居中对齐。

方法路径用途关键参数认证
POST/api/auth/login账号密码登录username,password否
POST/api/qr/start生成登录二维码source是
GET/api/qr/status轮询并保存账号uuid是
GET/api/accounts我的账号列表-是
DEL/api/accounts?ref=...删除账号ref/openid是
POST/api/wx/code获取小程序 coderef,app_id是
POST/api/yyb/launch-param生成云函数参数app_id,entry_url是
GET/api/me当前登录用户-是
POST/api/users新增控制台用户username,password,role管理员

字段说明

扫码来源和状态是最容易混淆的字段，单独列出。

字段位置可选值说明
source/api/qr/start bodyyyb gameassist应用宝 / 手游助手登录来源，不传默认应用宝。
uuid/api/qr/status query二维码会话 ID由 /api/qr/start 返回，用于轮询状态。
status扫码状态pending / scanned / authorized / confirmed只有 confirmed 表示账号已保存到「我的账号」。
ref业务接口 body/query账号 ID / OpenID / UIN用于指定调用 code 的账号。

示例

应用宝与手游助手只需要切换 source。

扫码保存账号
curl -X POST https://wx.a5t.cn/api/qr/start \
  -H 'X-Auth-Token: TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"source":"gameassist"}'

curl -H 'X-Auth-Token: TOKEN' \
  'https://wx.a5t.cn/api/qr/status?uuid=UUID'
获取 code 与启动参数
curl -X POST https://wx.a5t.cn/api/wx/code \
  -H 'X-Auth-Token: TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"ref":"OPENID或ID","app_id":"wx..."}'

curl -X POST https://wx.a5t.cn/api/yyb/launch-param \
  -H 'X-Auth-Token: TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"app_id":"wx...","entry_url":"?"}'

UIN 如果扫码资料未返回，会在首次获取 code 建立会话后自动同步到「我的账号」；这属于正常链路，不影响扫码入库。

在线调试

用于快速验证 token 和接口返回。

等待发送请求...
小程序助手 · 接口文档