WebSocket 快速开始
添加一个监控账号，打开服务端 WebSocket，然后输出每个 v1 消息信封。
运行 5 分钟连通性测试
添加一个监控账号，复制示例并运行。看到 TweetStream connected 表示认证成功。该账号发布内容后会收到事件。
运行 TypeScript 连通性测试
typescript
// bun add ws
// TWEETSTREAM_API_KEY=ts_... bun run smoke.ts
import WebSocket from "ws";
const apiKey = process.env.TWEETSTREAM_API_KEY;
if (!apiKey) {
throw new Error("Missing TWEETSTREAM_API_KEY");
}
const ws = new WebSocket("wss://ws-global.tweetstream.io/ws", [
"tweetstream.v1",
`tweetstream.auth.token.${apiKey}`,
]);
ws.on("open", () => {
console.log("TweetStream connected");
});
ws.on("message", (raw) => {
const event = JSON.parse(raw.toString());
console.log(event.t, event.op, event.d);
});
ws.on("close", (code, reason) => {
console.log("TweetStream closed", code, reason.toString());
});
ws.on("unexpected-response", (_request, response) => {
console.error("Connection rejected", response.statusCode, response.statusMessage);
response.resume();
process.exitCode = 1;
});
ws.on("error", (error) => {
console.error("WebSocket error", error.message);
});分发操作
| 类别 | 操作 | 含义 |
|---|---|---|
| tweet | content | 原始发帖、回复、引用、转推，或支持的 Truth Social 帖子内容 |
| tweet | meta | 为已知帖子添加 OCR、代币检测、CEX 和预测市场数据 |
| tweet | update | 更新已知帖子的字段 |
| tweet | delete, pin, unpin | 将已知帖子标记为已删除、已置顶或已取消置顶 |
| account | profile_update, follow, unfollow, affiliate_update | 被监控账号的状态变化 |
| charity | added | 新增慈善项目。可在控制台开启提醒 |
| news | article | 来自已开启媒体的文章 |
| control | twitter_handles_result | WebSocket 账号管理命令的结果 |