# 微信扫码登录第三方平台

> 微信扫码登录第三方平台（https://login.fps5.cn）是一个免申请微信开放平台的第三方微信扫码登录服务。开发者用微信扫码注册后创建项目，获得 client_id / client_secret，即可在自己的网站接入微信扫码登录 / 微信一键登录。平台统一维护微信网站应用，业务站无需接触 AppID / AppSecret；用户资料通过一次性 ticket 由业务后端换取，统一 openid / unionid 用户标识。

## 核心事实

- 平台名称：微信扫码登录第三方平台
- 官网：https://login.fps5.cn
- Base URL：https://login.fps5.cn
- 适用场景：需要微信扫码登录、但没有企业主体或不想申请微信开放平台网站应用的网站；一个账号可为多个站点接入。
- 前置条件：用微信扫码注册平台账号，创建项目并等待平台审核通过。
- 接入方式：页面内嵌二维码（GET /oauth/qr + 微信官方 wxLogin.js）或整页跳转（GET /oauth/authorize）。
- 换取用户资料：POST /api/user/info（别名 POST /api/v1/user/info），由业务后端携带 client_id、client_secret、code 调用。
- 关键限制：ticket 默认 300 秒且仅能使用一次；授权上下文有效期 1800 秒；项目必须审核通过且未停用；回调域名必须在项目域名白名单内。
- 用户标识：同一微信用户在所有项目中 openid / unionid 一致。

## 文档

- [使用说明（网页）](https://login.fps5.cn/docs)：从注册、创建项目到业务站接入的完整步骤与常见问题。
- [使用说明（Markdown）](https://login.fps5.cn/docs.md)：适合 AI 直接读取的纯文本版本。
- [API 文档（网页）](https://login.fps5.cn/api-docs)：接口参数、返回结构、错误码与多语言调用示例。
- [API 文档（Markdown）](https://login.fps5.cn/api-docs.md)：适合 AI 直接读取的纯文本版本。
- [PHP Demo](https://login.fps5.cn/php-demo)：无第三方依赖的 PHP 接入示例，服务端申请二维码参数、回调桥接、ticket 换票完整链路，含源码压缩包下载。
- [PHP Demo（Markdown）](https://login.fps5.cn/php-demo.md)：适合 AI 直接读取的纯文本版本。
- [Python 桌面 Demo](https://login.fps5.cn/python-demo)：PySide6 + requests 实现，不内嵌浏览器内核，含完整源码下载与扫码状态码说明。
- [Python 桌面 Demo（Markdown）](https://login.fps5.cn/python-demo.md)：适合 AI 直接读取的纯文本版本。

## 主要接口

- `GET /oauth/qr`：业务后端调用，返回渲染微信二维码所需的 appid、scope、redirect_uri、state。
- `GET /oauth/authorize`：浏览器跳转发起微信授权，参数为 client_id、redirect_url、state。
- `POST /api/user/info`：业务后端用一次性 ticket 换取用户资料（openid、unionid、昵称、头像等）。
- `GET /api/ping`：健康检查。