查询微信扫码登录状态

GET

/api/v1/auth/wechat/status/{state}

每次轮询使用创建会话返回的 state。completed 返回账号 access_token/refresh_token，浏览器还会设置 HttpOnly Cookie。成功响应不可缓存；停止轮询后安全保存凭证。

请求参数

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

操作成功。

Bodyapplication/json

示例

{
    "status": "completed",
    "access_token": "ACCOUNT_ACCESS_TOKEN_EXAMPLE_NOT_VALID",
    "token_type": "bearer",
    "refresh_token": "ACCOUNT_REFRESH_EXAMPLE_PLACEHOLDER",
    "expires_in": 900,
    "refresh_expires_at": 1793001600,
    "user": {
        "sub": "123",
        "username": "example-user",
        "name": "示例用户",
        "role": "customer",
        "developer_status": "active"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴503

修改于 2026-10-12 09:15:56

创建微信扫码登录会话

创建 GitHub 开发者绑定会话