元信息 实验性
WARNING
这是一个实验性功能,可能在未来的版本中发生变化。
元信息对象包含了与 SDK 状态相关、与具体的账号无关的信息,例如代理路由等。
元信息通过以下方式获取和更新:
- 在 WebSocket 推送方式下,
READY信令将提供完整的元信息; - 在 WebHook 推送方式下,应用启动时应当通过 API 获取元信息;
- 应用启动后,持续接收
META信令和登录事件对元信息进行更新。
需要注意的是,META 信令不反映登录状态变化,也不会包含 logins 字段。
元信息 API 通过 /{version}/meta/{method} 路由提供。通信方式与 HTTP API 类似,但不需要 Satori-Platform 和 Satori-User-ID 请求头。
类型定义
Meta
| 字段 | 类型 | 描述 |
|---|---|---|
logins | Login[] | 登录信息 |
proxy_urls | string[] | 代理路由列表 |
API
获取元信息
POST/meta返回一个 Meta 对象。
创建 WebHook 可选
POST/meta/webhook.create| 字段 | 类型 | 描述 |
|---|---|---|
url | string | WebHook 地址 |
token | string? | 鉴权令牌 |
移除 WebHook 可选
POST/meta/webhook.delete| 字段 | 类型 | 描述 |
|---|---|---|
url | string | WebHook 地址 |