rates.io:API状态码变更

原文链接

2024年2月6日 · 代表crates.io团队的Tobias Bieniek

Cargo和crates.io是在Rust 1.0发布前的紧张开发中被开发出来的,目的是满足管理依赖项的工具需求以及提供一个人们可以共享代码的注册表。这种快速的工作导致这些工具最初连接的API没有返回正确的HTTP响应状态码。在Rust 1.0发布后,Rust关于向后兼容性的稳定性保证使得修复这个问题变得不那么简单,因为我们希望旧版本的Cargo能继续与当前的crates.io API兼容。

当旧版本的Cargo收到一个非"200 OK"的响应时,它会像这样显示原始的JSON主体:

css 复制代码
错误:未能获得200 OK响应,得到400
头信息:
    HTTP/1.1 400 Bad Request
    Content-Type: application/json; charset=utf-8
    Content-Length: 171

主体:
{"errors":[{"detail":"缺少或空的元数据字段:description, license. 请参阅https://doc.rust-lang.org/cargo/reference/manifest.html了解如何上传元数据"}]}

这在拉取请求#6771中得到了改进,该请求在2019年中发布的Cargo 1.34中发布。从那时起,Cargo也支持接收4xx和5xx状态码,并且如果可能的话,从JSON响应中提取错误信息。

在2024年3月4日,我们将把API从返回错误的"200 OK"状态码切换到新的4xx/5xx行为。在此更改后,Cargo 1.33及以下版本将继续工作,但会显示原始的JSON主体,而不是格式化良好的错误信息。我们相信,这种降级的错误信息显示不会影响很多用户。根据crates.io的请求日志,只有非常少的请求是由Cargo 1.33及更早版本发出的。

以下是此次变更将影响的API端点列表:

  • GET /api/v1/crates
  • PUT /api/v1/crates/new
  • PUT /api/v1/crates/:crate/:version/yank
  • DELETE /api/v1/crates/:crate/:version/unyank
  • GET /api/v1/crates/:crate/owners
  • PUT /api/v1/crates/:crate/owners
  • DELETE /api/v1/crates/:crate/owners

所有其他端点已经使用常规HTTP状态码一段时间了。

如果您仍在使用Cargo 1.33或更早版本,我们建议您升级到更新版本,以获得改进的错误信息和Cargo团队自那时以来构建的所有其他好东西。

相关推荐
wflynn7 小时前
GitHub 今日推荐|kiri:clone3 系统调用直达容器,2.5 毫秒启动无 runc 中间层
docker·rust·kubernetes·开源·github·containers
SomeOtherTime10 小时前
第 4 讲:突破静态枷锁——智能指针(Box/Rc/Arc)与内部可变性(Cell/RefCell/UnsafeCell)的内存暗道
rust
SomeOtherTime16 小时前
第 9 讲:异步并发与 Pin 的底层解剖——async/await 无栈协程状态机脱糖、自引用死锁的终极救赎与 Future/Waker 驱动模型
rust
wflynn1 天前
GitHub 今日推荐|Stela:在 PC 上直接启动 macOS 的翻译层
rust·开源·github
aifannihao1 天前
Rust 1.100 的 DropGuard:用 Python 实测失败回滚与吞异常
python·rust·异常处理·标准库·contextlib
鶴哥只手遮天2 天前
《rustc 内幕》第 1 章 全景:rustc 编译流水线与 crate 版图
后端·rust·开源
SomeOtherTime3 天前
Rust 闭包语法和原理(AI回答)
开发语言·后端·rust
SomeOtherTime3 天前
Rust集合(AI回答)
开发语言·后端·rust
SomeOtherTime3 天前
Rust 泛型与特性讲解(AI回答)
rust
青川Lapis4 天前
RUST:错误处理 thiserror + anyhow 工程化
rust