---
title: "事件参考"
canonical_url: "https://tweetstream.io/zh-cn/docs/payloads-detections-ocr"
last_updated: 2026-09-24
---

# 事件参考

找到事件类别，再打开完整载荷与集成指南。

Canonical URL: https://tweetstream.io/zh-cn/docs/payloads-detections-ocr

## 推文内容

将 `tweet/content` 作为首个可用帖子，再按 `author.platform` 分流。

- [打开社交内容参考](https://tweetstream.io/zh-cn/docs/social-content): 比较 Twitter、Truth Social 和币安广场载荷。

### 按平台分流

帖子键使用 `(author.platform, tweetId)`。缺少 `platform` 时按 `twitter` 处理。

### 读取引用

引用帖子及附件保留在 `ref` 中。每个嵌套引用都有自己的 `tweetId`。

## 富化元数据

每次收到 `tweet/meta` 快照时，替换 `(platform, tweetId)` 对应的元数据。不要保留新快照中缺少的字段。

- [打开 tweet/meta 参考](https://tweetstream.io/zh-cn/docs/tweet-updates-lifecycle#meta): 读取检测、OCR、代币、交易所和市场字段。

## 推文更新

只更新 `tweet/update` 中存在的字段，不要替换整个帖子。

- [打开 tweet/update 参考](https://tweetstream.io/zh-cn/docs/tweet-updates-lifecycle#update): 应用文本补全、引用、媒体、投票和文章。

### 匹配帖子

使用 `(platform, tweetId)` 匹配每条更新。

### 替换引用快照

更新包含 `ref` 时，用该快照替换已存引用。

### 补全可选字段

事件中存在的投票、文章和媒体值会完整替换对应字段。

## 推文生命周期

将删除、置顶和取消置顶应用到已存帖子，不要覆盖原内容。

- [打开生命周期事件参考](https://tweetstream.io/zh-cn/docs/tweet-updates-lifecycle#lifecycle-events): 复制完整的删除、置顶和取消置顶载荷。

## 账号事件

在 `account` 类别下分发资料、关注、取消关注和关联账号变更。

- [打开账号事件参考](https://tweetstream.io/zh-cn/docs/profile-follow-affiliate): 复制每种账号事件及其存储键。

### 分发账号操作

按 `op` 分流。遇到未知操作时忽略消息，不要关闭 WebSocket。

### 存储关联账号关系

将操作应用到 `(organization.id, member.id)`，`eventId` 仅用于识别完全相同的重放。

### 回放已存变更

在 History API 中使用 `type=PROFILE`、`FOLLOW` 或 `AFFILIATE`。

## 喊单

已选择账号的结构化 `account/callout` 事件通过同一个 WebSocket 发送。

- [打开喊单事件参考](https://tweetstream.io/zh-cn/docs/callouts): 配置账号并读取喊单者、代币、价格和时间字段。

### 选择账号

在喊单标签页添加 pump.fun 用户名、Solana 钱包或个人主页链接。

### 分发事件

收到 `account/callout` 时提醒，再合并通常在几秒内到达的 `account/callout_update`。先读取账号和代币地址，再处理可选字段。

### 使用标识符

按信封 `id` 去重。将补充数据合并到 `d.updateOf` 指向的条目，包括嵌套字段，不再发送提醒。

## 慈善项目事件

启用慈善项目提醒后，会收到仅实时发送的 `charity/added` 事件。

- [打开慈善项目事件参考](https://tweetstream.io/zh-cn/docs/charity): 复制完整事件及可选地点字段。

## 新闻文章

已启用媒体发送 `news/article`；已存文章使用独立的新闻 History API。

- [打开新闻事件与 History](https://tweetstream.io/zh-cn/docs/news): 选择媒体、接收文章，并使用 `nextCursor` 继续翻页。

### 选择媒体

筛选实时事件前，先读取并更新已启用媒体集合。

### 读取实时文章

使用消息信封 `id` 实现幂等处理，并随文章保存 `source.id`。

### 翻阅 History

将 `nextCursor` 原样传回，直到它为 null。

## 事件顺序

维护幂等的本地投影。WebSocket 消息信封不含序列号。

### 接收内容

保存第一条可用的内容事件。

### 替换富化数据

按帖子键替换每个实时元数据快照。

### 应用生命周期事件

将生命周期操作应用到同一帖子。

## 控制消息

使用 `auth_pong` 记录连接状态，使用 `twitter_handles_result` 读取命令结果。

- [打开控制消息参考](https://tweetstream.io/zh-cn/docs/control): 复制认证和账号管理消息。

## 账号管理通道

通过账号管理 WebSocket 或 REST API 关注或取消关注受监控的 Twitter 账号。

- [读取命令结果](https://tweetstream.io/zh-cn/docs/control#twitter-handles-result): 处理部分成功、幂等成功和失败行。
- [使用 REST 管理账号](https://tweetstream.io/zh-cn/docs/account-management): 添加、移除、查看和配置受监控账号。
