发起当前用户的外部身份绑定

POST

/api/v1/auth/external-identities/{slug}/bind

必须同时携带有效 Session Cookie、CSRF Cookie 和 X-CSRF-Token。服务端创建独立的一次性 binding state，将 purpose、用户 ID、Session ID 和 session_epoch 与 PKCE verifier 一起保存在 Redis；该流程不会调用自动建号逻辑，也不会按 email 自动关联用户。

请求参数

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

已创建独立的一次性 binding state、PKCE verifier 及安全 state Cookie；响应返回外部 OAuth 授权 URL，浏览器必须在读取同源 JSON 后自行导航到该 URL。

Headers

Bodyapplication/json

示例

{
    "authorization_url": "http://example.com"
}

🟠400请求有误

🟠401没有权限

🟠404记录不存在

🔴503服务器故障

修改于 2026-08-18 09:01:51

查询当前用户已绑定的外部身份

完成外部身份绑定回调