{
  "email":    "alice@example.com",
  "username": "alice",
  "password": "MyP@ssw0rd"
}

{ "ok": true, "userId": "usr_01abc" }

{
  "email":    "alice@example.com",
  "password": "MyP@ssw0rd"
}

{
  "token": "eyJhbGciOiJIUzI1NiJ9...",
  "user": {
    "id": "usr_01abc",
    "username": "alice",
    "email": "alice@example.com"
  }
}

Authorization: Bearer <token>

{
  "users": [
    { "id": "usr_01abc", "username": "alice", "avatarUrl": null }
  ]
}

Authorization: Bearer <token>

{ "username": "alice_new" }

{ "ok": true }

Authorization: Bearer <token>

{ "oldPassword": "OldP@ss", "newPassword": "NewP@ss" }

{ "ok": true }
// 注意：当前 token 立即失效，需使用新密码重新登录

Authorization: Bearer <token>

{ "friendId": "usr_02xyz" }

{ "ok": true }
// 对方通过通知频道实时收到 { type: "contact:request", fromUserId, fromUsername }

Authorization: Bearer <token>

{ "ok": true }
// 双方 contacts 表各自写入一条 accepted 记录

Authorization: Bearer <token>

{
  "contacts": [
    { "id": "usr_02xyz", "username": "bob", "avatarUrl": null }
  ]
}

Authorization: Bearer <token>

{ "name": "产品团队", "memberIds": ["usr_02xyz", "usr_03def"] }

{ "room": { "id": "room_abc", "name": "产品团队", "type": "group" } }

Authorization: Bearer <token>

{ "targetUserId": "usr_02xyz" }

{ "room": { "id": "room_xyz", "type": "direct" } }

Authorization: Bearer <token>

{
  "rooms": [
    {
      "id": "room_abc", "name": "产品团队", "type": "group",
      "lastMessage": { "content": "部署完成 ✅", "createdAt": "2026-05-03T10:00:00Z" },
      "unreadCount": 3
    }
  ]
}

Authorization: Bearer <token>

{
  "messages": [
    {
      "id": "msg_001", "roomId": "room_abc",
      "senderId": "usr_01abc", "senderUsername": "alice",
      "content": "部署完成 ✅", "type": "text",
      "createdAt": "2026-05-03T10:00:00Z"
    }
  ],
  "nextCursor": "msg_000"   // 传给下一次请求的 ?cursor= 参数，null 表示已到最早
}

Authorization: Bearer <token>

{ "content": "部署完成 ✅（已验证）" }

{ "ok": true }
// 房间内所有在线成员通过 WS 收到 { type: "message:edit", messageId, content }

Authorization: Bearer <token>

{ "ok": true }
// WS 广播 { type: "message:recall", messageId }

Authorization: Bearer <token>
Content-Type: multipart/form-data

file=@/path/to/photo.jpg

{
  "file": {
    "id":       "file_xyz",
    "key":      "uploads/2026/05/photo_abc123.jpg",
    "filename": "photo.jpg",
    "mimeType": "image/jpeg",
    "size":     204800
  }
}
// 发消息时在 WS 携带 fileId: "file_xyz", msgType: "file"

Authorization: Bearer <token>

{
  "platform":  "feishu",
  "name":      "我的飞书机器人",
  "appId":     "cli_xxxxxxxxxx",
  "appSecret": "xxxxxxxxxxxxxxxx"
}

{
  "integration": {
    "id":          "int_001",
    "platform":    "feishu",
    "name":        "我的飞书机器人",
    "webhookUrl":  "https://worker.dev/webhook/feishu?integrationId=int_001"
  }
}
// 将 webhookUrl 填入飞书应用的「事件订阅」请求地址

Authorization: Bearer <token>

{
  "poll": {
    "question": "本周发版时间？",
    "options":  ["周三", "周四", "周五"],
    "votes":    [3, 1, 2],
    "myVote":   0          // 当前用户已选索引，null 表示未投
  }
}

Authorization: Bearer <token>

{ "optionIndex": 0 }

{ "ok": true }
// WS 广播最新票数给房间所有成员

Authorization: Bearer <token>

{
  "tasks": [
    { "id": "task_001", "title": "抖音下载生产环境验证", "status": "todo", "createdAt": "..." },
    { "id": "task_002", "title": "邮件 Tab 上线验收",    "status": "done", "createdAt": "..." }
  ]
}

Authorization: Bearer <token>

{ "status": "done" }

{ "ok": true }

Authorization: Bearer <token>

{ "status": "accepted" }   // 或 "rejected"

{ "ok": true }
// accepted 时 Agent 会继续执行被提案的操作（如发送消息/创建任务）

Authorization: Bearer <token>

{ "ok": true, "bookmarkId": "bm_xyz" }

Authorization: Bearer <token>

{ "ids": ["msg_001", "msg_005", "msg_012"] }
// 前端用此列表在消息气泡上显示收藏标记

Authorization: Bearer <token>

{ "url": "https://mp.weixin.qq.com/s/xxxxx" }

{
  "bookmark": {
    "id":    "ubm_001",
    "url":   "https://mp.weixin.qq.com/s/xxxxx",
    "title": null,   // OGP 异步抓取，稍后填充
    "image": null
  }
}

Authorization: Bearer <token>

{
  "urls": [
    "https://example.com/article-1",
    "https://example.com/article-2"
  ]
}

{ "inserted": 2, "skipped": 0 }
// skipped 为已存在的重复 URL 数量

Authorization: Bearer <token>

{ "roomId": "room_abc" }

{ "ok": true }
// 书签 URL 以文本消息形式发送到指定房间

Authorization: Bearer <token>

{
  "title":       "示例文章标题",
  "description": "这是文章的描述摘要...",
  "image":       "https://example.com/og-image.jpg",
  "favicon":     "https://example.com/favicon.ico",
  "siteName":    "Example"
}

Authorization: Bearer <token>

{
  "downloadUrl": "https://aweme.snssdk.com/aweme/v1/play/?video_id=xxx&ratio=720p",
  "title":       "视频标题",
  "cover":       "https://p3.douyinpic.com/xxx.jpg"
}

Authorization: Bearer <token>

{ "url": "https://accounts.google.com/o/oauth2/v2/auth?client_id=...&state=..." }
// 前端跳转此 URL，用户授权后回调写入 token

Authorization: Bearer <token>

{
  "messages": [
    {
      "id":      "gmail_msg_abc",
      "from":    "sender@example.com",
      "subject": "本周五 14:00 产品评审",
      "snippet": "请参加本周产品评审会议...",
      "date":    "2026-05-03T10:24:00Z",
      "unread":  true
    }
  ],
  "nextPageToken": "token_xyz"   // 传入下次请求的 pageToken，null 表示最后一页
}

Authorization: Bearer <token>

{
  "accountId": "eacc_001",
  "to":        "colleague@example.com",
  "subject":   "会议纪要",
  "body":      "<p>附上本次会议纪要，请查阅。</p>"
}

{ "ok": true }

Authorization: Bearer <token>

{
  "accountId": "eacc_001",
  "body":      "<p>收到，准时参加。</p>"
}

{ "ok": true }

Authorization: Bearer <token>

{
  "pairCode": "AB12CD",   // Bridge App 扫描此码完成配对
  "expiresIn": 300        // 有效期（秒）
}

Authorization: Bearer <token>

{
  "online": true,
  "deviceName": "Alice 的 iPhone",
  "lastSeen":   "2026-05-03T09:55:00Z"
}

{ "secret": "your-admin-secret" }

{ "token": "eyJhbGci..."  }
// 后续管理端请求携带 Authorization: Bearer <token>

Authorization: Bearer <admin-token>

{
  "users":        42,
  "messages":  18350,
  "rooms":        28,
  "integrations":  6
}

Authorization: Bearer <admin-token>

{ "value": "https://www.icloud.com/shortcuts/xxxxx" }

{ "ok": true }
// 官网快捷指令按钮将动态读取此值并覆盖默认链接

Authorization: Bearer <admin-token>

{ "ok": true }
// Agent 以普通成员身份加入，收到消息后异步进入 Workers Queue 处理