13 KiB
13 KiB
| title | linkTitle | type | layout | outputs | date | ||
|---|---|---|---|---|---|---|---|
| v1.11 更新日志 | v1.11 | docs | changelog |
|
2024-06-20 |
{{< boxes/warning >}} 本页面的翻译未经核对，可能存在翻译质量不佳、错翻、漏翻等情况。您可以在 Forgejo 存储库 打开 Issue、提交 Pull Request 或邮件联系我们提出改进建议和参与翻译与核对。 {{< /boxes/warning >}}
客户端-服务器 API
弃用说明
- 根据 MSC4126，通过查询字符串进行认证现已弃用，应改为使用
Authorization头。(#1808) /_matrix/media/*端点的使用现已弃用。已提供新的认证端点。(#1858)
新增端点
GET /_matrix/client/v1/media/config(#1858)GET /_matrix/client/v1/media/download/{serverName}/{mediaId}(#1858)GET /_matrix/client/v1/media/download/{serverName}/{mediaId}/{fileName}(#1858)GET /_matrix/client/v1/media/preview_url(#1858)GET /_matrix/client/v1/media/thumbnail/{serverName}/{mediaId}(#1858)
向后兼容更改
- 按照 MSC3291 增加对 VoIP 通话静音功能的支持。(#1755)
- 按照 MSC2705 ，为
GET /thumbnail增加可选的animated查询字符串选项。(#1757) - 按照 MSC1692 ，在注册时指定服务条款。(#1812)
- 按照 MSC2191 ，增加对数学消息的支持。(#1816)
- 按照 MSC3967 ，首次上传交叉签名密钥时不再需要 UIA。(#1828)
- 按照 MSC4115 ，为事件添加新的
unsigned.membership属性。(#1847) - 按照 MSC3916 ，媒体下载和缩略图现需认证。(#1858)
- 按照 MSC3916 ，部分媒体端点已统一迁移至
/_matrix/client/{version}/media/*，不再使用/_matrix/media/*。(#1858)
规范澄清
- 增加
/logout端点，并明确哪些端点不需 JSON 请求体。(#1644) - 明确
POST /login请求的type必须为GET /login响应返回的类型之一。(#1776) - 类型中链接现有语法（如适用）。(#1813)
- 将“恢复密钥”重命名为“备份解密密钥”。(#1819)
- 明确在二维码验证中应使用设备的 Ed25519 签名密钥（而非 Curve25519 身份密钥）。(#1829)
- 修复规范中的各种拼写错误。(#1832, #1841, #1852, #1853)
- 规范生成设备验证二维码时应使用的编码。(#1839)
- 明确在
POST /account/password和POST /account/deactivate端点访问令牌为可选项。(#1843) - 更一致地使用 RFC 2119 关键词。(#1846, #1861)
- 将用户、房间和事件 ID 的长度限制移至附录，并明确长度以字节为单位计量。(#1850)
- 明确关系递归应限制深度。(#1854)
- 在功能配置表中补充缺失的 secrets、第三方邀请及房间标签模块。(#1860)
- 明确服务器名称的使用时机并链接其定义。(#1862)
- 明确在检查
m.room.encrypted事件时密钥的存放位置。(#1863) - 明确
/media/v3/upload/{serverName}/{mediaId}端点需要认证。(#1872)
服务器-服务器 API
弃用说明
- 客户端-服务器 API 下的
/_matrix/media/*端点使用现已弃用。已提供新的认证端点。(#1858)
新增端点
GET /_matrix/federation/v1/media/download/{mediaId}(#1858)GET /_matrix/federation/v1/media/thumbnail/{mediaId}(#1858)
向后兼容更改
规范澄清
- 类型中链接现有语法（如适用）。(#1813)
- 明确在
X-MatrixAuthorization头的参数列表中逗号前后允许存在空格。(#1818) - 明确
/v2/send_join响应的event字段仅在事件由本地服务器签名时才为必需。(#1834, #1840) - 更新被 RFC 9110 替代的 RFC 7235 和 RFC 7230 引用。(#1844)
- 修复规范中的各种拼写错误。(#1877)
应用服务 API
规范澄清
- 明确应用服务应收到与
sender_localpart用户相关的事件通知。(#1810)
身份服务 API
弃用说明
推送网关 API
无重大更改。
房间版本
规范澄清
- 明确撤回事件仍须遵守所有相关认证规则。(#1824)
- 修复规范中的各种拼写错误。(#1827, #1848)
- 修复房间版本 1 和 2 的事件格式渲染问题。(#1883)
- 使用 Hugo 而非 JavaScript 生成目录。(#1884)
附录
弃用说明
规范澄清
内部更改/工具
规范澄清
- 更新规范发布流程及相关文档。(#1759)
- 修复
@matrix-org/spec的 npm 发布脚本。(#1765) - 修正
CONTRIBUTING.rst中的格式问题。(#1769) - 改善移动设备下的渲染效果。(#1770, #1771)
- 修正安全方案的 OpenAPI 定义。(#1772)
- 简化
resolve-refspartial 的使用。(#1773) - 修复 Hugo 警告。(#1775, #1788)
- 修复
github-labels.rst。(#1781) - 更新依赖项。(#1786, #1803, #1804)
- 在 OpenAPI 和 JSON Schemas 中递归解析
allOf。(#1787) - 修正
render-object-tablepartial 属性类型解析。(#1789) - 抽取出通用的
Tag类型定义。(#1793) - 将规范渲染所用 Hugo 版本升级至 v0.124.1。(#1794)
- 增加对
patternProperties的模式格式支持。(#1796) - 清理 OpenAPI 定义中不必要的
allOf。(#1797) - 在对象表格中显示“附加属性”信息。(#1798)
- 修正
oneOf下 schemas 的锚点。(#1799) - 在 OpenAPI 定义中引用
OneTimeKeysschema。(#1800) - 不对只包含
additionalProperties或patternProperties的对象使用title。(#1801) - 在
definitionshortcode 中添加锚点。(#1802) - 为 Towncrier CI 任务设置 python 版本。(#1805)
- 在 CI 中用环境文件替换
set-output。(#1806) - 渲染响应头信息。(#1809)
- 更多地方在受支持格式下使用
patternProperties。(#1813) - 增加对字符串格式渲染的支持。(#1814)
- 重构内容存储库端点的 OpenAPI 定义。(#1822)
- 清理拉取请求模板。(#1831)
- 示例中不再添加空数组。(#1849)
- 使用 Hugo 而非 JavaScript 生成目录。(#1851, #1885)
- 修正规范发布议题模板中的语法错误。(#1856)
- Netlify 构建任务使用环境变量。(#1865)
- 在请求与响应内容类型信息中渲染新增/变更内容。(#1876)
- 修正生成 HTML 的验证错误。(#1880)
- 确保大部分生成的 HTML ID 唯一。(#1881)
- 允许为 API 端点生成的 HTML ID 指定前缀。(#1882)