Skip to main content
Element Software
12.5 and 12.7
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

关于 Element 软件 API

贡献者

Element API 基于 HTTPS 上的 JSON-RPC 协议。JSON-RPC 是一种基于轻型 JSON 数据交换格式的简单文本 RPC 协议。客户端库可用于所有主要编程语言。

您可以通过 HTTPS POST 请求向 API 端点发出 API 请求。POST 请求的正文是一个 JSON-RPC 请求对象。API 当前不支持批处理请求(在一个 POST 中包含多个请求对象)。在提交 API 请求时,必须使用 "application/json-rpc" 作为请求的内容类型,并确保正文未进行格式编码。

备注 Element Web UI 会使用本文档中所述的 API 方法。您可以通过启用 API 日志来监控 UI 中的 API 操作;这样,您可以查看向系统发出的方法。您可以同时启用请求和响应,以查看系统如何对发出的方法做出响应。

除非另有说明,否则 API 响应中的所有日期字符串均采用 UTC+0 格式。

备注 如果存储集群负载过重,或者您连续提交多个 API 请求而没有中间延迟,则某个方法可能会失败并返回错误 "xDBVersionMismatch" 。如果发生这种情况,请重试方法调用。