专栏名称: 非法加冯

云计算泥石流，数据库老司机。

天翼云API中的鸡鸡ID

非法加冯 · 公众号 · 互联网安全 · 2025-01-31 11:06

主要观点总结

本文主要讨论了云服务的API设计的重要性以及一个关于天翼云查询云主机云硬盘列表API的实例。作者指出云服务中的API设计不能轻易改动，错误的设计会带来长期的影响。文章还以一个天翼云的API为例，说明了即使在API兼容性要求下，错误的参数名仍然需要被保留，即使已逐渐不被推荐使用。

关键观点总结

关键观点1: 云服务API设计的重要性

文章强调在云服务领域，API的设计至关重要，一旦设计错误，后果将长期存在，影响公司的声誉和客户的使用体验。

关键观点2: 天翼云的查询云主机云硬盘列表API为例

文章以一个具体的实例——天翼云的查询云主机云硬盘列表API，说明了API设计不当带来的问题，如参数名错误、需要保留荒谬可笑的参数等。

关键观点3: API兼容性要求与错误参数保留的问题

文章指出，由于API兼容性要求，即使已知参数存在错误或逐渐不被推荐使用，只要仍有客户使用，服务商就不得不继续保留这些参数。

关键观点4: 对云从业者的建议

文章提醒云从业者，在API设计中应避免交给实习生随便设计，强调专业性和严谨性。

正文

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

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

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

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

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

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

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

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

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

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

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

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

推荐文章

平安鼎 · 破45亿！涉春节档，600多个账号被禁言

4 小时前

默安科技 · 烟花璀璨，辞旧迎新！

3 天前

环球网 · DeepSeek火爆全网，英伟达大跌17%

3 天前

环球网 · DeepSeek火爆全网，英伟达大跌17%

3 天前

山东市场监管 · 省市场监管局召开强化今冬明春特种设备安全监管工作视频会议

4 天前

山东市场监管 · 省市场监管局召开强化今冬明春特种设备安全监管工作视频会议

4 天前

互联网坊间八卦 · 360辟谣：网传哺乳期员工被裁，内容失实

5 天前

互联网坊间八卦 · 360辟谣：网传哺乳期员工被裁，内容失实

5 天前

大家-腾讯新闻 · 西闪：黑天鹅频出的时代，你需要一点概率思维丨冷门书

8 年前

张德芬空间 · 妈妈决定着家的温度

8 年前

中国经济网 · 马来西亚警方：遇害朝鲜男子脸部发现VX毒剂丨最新

7 年前

人人都是产品经理 · 智能投顾、资产配置、内容营销……2017年理财平台都在如何转型？

7 年前

铅笔道 · 获优客工场投资你来背书它招聘她用一个App挖掘职场闲置人脉

7 年前