快速开始快速开始

用最短路径理解 StarWork 的核心入口、登录方式与基础使用路径。

产品使用指南产品使用指南

了解官网、价格、账号和最新动态在 StarWork Web 端中的作用。

接入说明接入说明

面向开发者说明认证接口、会话模型与页面路由兼容关系。

部署指南部署指南

面向运维与实施方说明 Web 服务、数据库与内容种子的部署关注点。

解答登录、注册、价格和后台入口相关的常见问题。

最佳实践最佳实践

给产品、运营和实施团队的推荐使用方式。

接入说明开发者

接入说明

面向开发者说明认证接口、会话模型与页面路由兼容关系。

接入说明

StarWork Web 端复用现有 auth-service 认证能力，同时新增浏览器会话支持。

兼容保留的接口

GET /login
GET /auth/providers
GET /auth/:provider/start
GET /auth/:provider/callback
POST /auth/session/exchange
POST /auth/session/transfer
GET /auth/session/handoff
GET /auth/session/me
POST /auth/logout

新增的 Web 语义

GET /auth/:provider/start 支持可选 query：

txt

client=desktop|web
returnTo=/

POST /auth/session/exchange 支持：

json

{ "grant": "<code>", "channel": "desktop|web" }

POST /auth/session/transfer 支持：

json

{ "returnTo": "/" }

回调策略

桌面端：保持 deep link 返回桌面应用
Web：在浏览器中写入 starwork_web_session cookie，并跳回 returnTo

会话家族

每次首次登录都会生成一个 session_family_id，桌面端与 Web 通过 transfer / bootstrap 建立的新会话会复用同一个 family。

这意味着：

登录一次，多端可通行
任一端调用 POST /auth/logout，同一 family 下的 desktop / web 会话会一起失效

← 产品使用指南

部署指南 →