---
title: "SSE 实时同步流"
method: GET
path: "/sync/stream"
tags: ["Sync"]
---

# SSE 实时同步流

`GET /sync/stream`

Server-Sent Events 端点，用于持续实时同步。

**协议流程：**
1. 客户端连接：`GET /api/sync/stream?token={jwt}&since={cursor}`
2. 服务端追赶：发送游标之后的所有事件（`event: sync`）
3. 服务端发送 `event: caught_up` 标记追赶完成
4. 实时推送：新事件通过 Redis pub/sub 推送（`event: sync`）
5. 心跳：每 25 秒发送 `event: heartbeat`

**SSE 事件类型：**
- `sync` — 同步事件数据
- `caught_up` — 追赶完成，进入实时模式
- `heartbeat` — 保活信号

认证通过 `?token=` 查询参数传递（不使用 Authorization header）。

## Query parameters

- `token` string, required
- `since` string

## Response `200`

SSE 事件流

## 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)