瑞典马工

天翼云,API设计要认真啊

有些朋友很喜欢写脏代码,”先上线再说,以后再改”,他们这样说。

对于大多数互联网应用的代码,确实如此,无非就是增加些版本管理的负担。

但是云服务不一样,API 尤其不一样,基本改不动。如果你设计错了,这个耻辱会跟随你很多年,并且一直公开展示,供大家嘲笑。

有读者投稿一个行业耻辱柱,大家可以看一下天翼云的查询云主机的云硬盘列表 API

https://www.ctyun.cn/document/10026730/10596897

懒得打开链接的可以看我截的图

Image

显然,dickid 是个很初级的错误,天翼云也修正为diskid了。但是由于 API 兼容性要求,天翼云不得不保留这个荒谬可笑的鸡鸡 id 参数。

两年多过去了,天翼云还只能跪求客户:

云硬盘ID,推荐使用diskID,该字段将在后续进行逐步下线处理

dickIDString云硬盘ID,推荐使用diskID,该字段将在后续进行逐步下线处理70a3768d-386e-416c-8abc-fc467e67432c
diskIDString云硬盘ID

只要有一个客户还在用这个版本的 API,天翼云就没办法下线这个参数,就只能自己把这个耻辱挂出来,供大家嘲笑。

各位云从业者,API 设计,别交给实习生随便乱搞了