Tab SyncTab Sync

API 参考

Tab Sync 后端提供 RESTful HTTP API，基础路径为 /v1/tab-sync。

认证

所有需要鉴权的接口使用 Authorization: Bearer <token> 请求头，Token 由后端控制台生成。

通用响应

{
  "code": 0,
  "success": true,
  "data": {},
  "message": "",
  "traceId": ""
}
  • code = 0 表示成功，非 0 表示失败。
  • 实际数据在 data 字段中。

接口一览

版本与认证

方法路径说明
GET/v1/tab-sync/version获取服务端版本信息
POST/v1/tab-sync/auth/verify-token验证 Token 有效性

工作组

方法路径说明
GET/v1/tab-sync/workspaces获取所有工作组（includeSystem=true 含系统分组）
POST/v1/tab-sync/workspaces创建工作组
PUT/v1/tab-sync/workspaces/:id更新工作组
DELETE/v1/tab-sync/workspaces/:id删除工作组
POST/v1/tab-sync/workspaces/:id/tabs按 URL 添加标签页
PATCH/v1/tab-sync/workspaces/:id/tabs/:tabId更新标签页
DELETE/v1/tab-sync/workspaces/:id/tabs/:tabId删除标签页（进入回收站）
POST/v1/tab-sync/workspaces/:id/tabs/move移动 / 排序标签页

标签

方法路径说明
GET/v1/tab-sync/tags获取标签列表（可按 scope 过滤）
POST/v1/tab-sync/tags创建标签
PUT/v1/tab-sync/tags/:id更新标签
DELETE/v1/tab-sync/tags/:id删除标签

回收站

方法路径说明
GET/v1/tab-sync/recyclebin获取回收站列表
POST/v1/tab-sync/recyclebin/:id/restore恢复标签页
DELETE/v1/tab-sync/recyclebin/:id彻底删除标签页
DELETE/v1/tab-sync/recyclebin清空回收站

设备

方法路径说明
GET/v1/tab-sync/devices获取已注册设备列表
POST/v1/tab-sync/devices/register注册设备
DELETE/v1/tab-sync/devices/:id注销设备

下一步