Wechat-Scan-Login

接口说明

Wechat-Scan-Login 接口用于通过微信扫码方式完成 Web 或 App 应用的登录授权流程。开发者调用该接口可获取二维码链接及授权状态，实现用户扫码登录功能。支持获取内置应用列表、生成二维码、查询登录状态及获取访问令牌等操作。

调用地址

/api/wechat/scan_login/index.php

请求方式

支持 GET 和 POST 方法。

鉴权说明

本接口无需任何鉴权密钥。

请求参数

成功响应示例

{
  "code": 0,
  "data": {
    "uuid": "031usZkE1kcHFa12",
    "appid": "wx48db31d50e334801",
    "type": "web",
    "qrcodeUrl": "https://open.weixin.qq.com/connect/qrcode/031usZkE1kcHFa12",
    "redirect_uri": "https://y.qq.com/n/ryqq/portal/index",
    "timestamp": 1788684465490
  },
  "message": "success"
}

响应字段说明

错误响应示例

{
    "code": 1,
    "msg": "请求过于频繁",
    "errcode": 11005
}

业务错误码说明

调用示例

终端 curl（bash）

curl -X POST "https://api.example.com/api/wechat/scan_login/index.php" \
  -d "action=getQrCode&type=web&appid=wx48db31d50e334801&redirect_uri=https://example.com/callback"

PHP

注意事项

• 本接口无鉴权要求，但调用方需妥善保管 appid 等参数，避免泄露至前端代码或公开仓库。
• 频率限制为每分钟约 123 次，超出限制将触发熔断，请合理控制请求间隔，批量调用建议做节流处理。
• action 参数决定操作流程，常见序列为 getApps → getQrCode → checkLogin → getAccessToken → getUserInfo，各步骤需按序调用，跳过检查步骤可能导致后续流程失败。
• type=web 时建议携带 redirect_uri，用于授权回调；未携带时微信可能返回默认跳转地址或校验失败。
• secret 为可选参数，当前版本用途未公开，非必填项可忽略。
• 返回的 uuid 与 qrcodeUrl 需配合前端扫码组件展示，扫码完成后通过 action=checkLogin 轮询状态，轮询间隔建议不低于 1 秒，避免高频请求触发限流。
• 所有接口调用均走 HTTPS 协议，请勿降级至 HTTP，否则可能导致请求被拦截或数据明文传输。
• 接口返回 code != 0 时，以 message 字段为准排查原因，常见错误包括 appid 无效、type 不匹配、二维码已过期等。