---
title: "增量同步（轮询）"
method: GET
path: "/sync"
tags: ["Sync"]
---

# 增量同步（轮询）

`GET /sync`

游标分页增量同步端点。返回指定游标之后的同步事件。
仅返回当前用户参与的对话相关事件。

**同步事件类型：**
- `message.new` — 新消息
- `message.edit` — 消息编辑
- `message.delete` — 消息删除
- `conversation.create` — 创建对话
- `conversation.update` — 更新对话
- `conversation.archive` — 归档对话
- `participant.add` — 添加参与者
- `participant.remove` — 移除参与者（移除前写入，被移除用户也能看到）

**同步流程：**
1. 首次连接，使用 `since=0`
2. 本地保存返回的 `cursor`
3. 下次同步使用 `since={cursor}`
4. 如果 `hasMore=true`，继续获取

## Query parameters

- `since` integer
- `limit` integer

## Response `200`

同步事件

- object
  - `ok` boolean
  - `data` object
    - `events` SyncEvent[]
      - `seq` integer — 事件序列号（全局递增，用作游标）
      - `type` 'message.new' | 'message.edit' | 'message.delete' | 'conversation.create' | 'conversation.update' | 'conversation.archive' | 'participant.add' | 'participant.remove' — 事件类型
      - `data` object — 事件数据（内容因类型而异）
      - `conversationId` string — 关联的对话 ID
      - `at` string, date-time — 事件时间
    - `cursor` integer — 下次同步使用此值作为 since
    - `hasMore` boolean — 是否还有更多事件

## Other responses

- `401` — 未认证或 Token 无效

---

[API](https://skmtc.net/prismer-ai/apis/prismer-im-server-api.md) · [All operations](https://skmtc.net/prismer-ai/apis/prismer-im-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prismer-ai/prismer-im-server-api/revisions/b27b5d973513/schema)