后端工程师,如何无脑设计一些shi一样的URI,来恶心移动/前端工程师呢?
希望本文能给大家一些启示。
方法一:搞一些不知所谓的名称。
例如:
http://api.example.com/68dd0-a9d3-11e0-9f1c style="font-size: 15px;letter-spacing: 1px;">
千万不能搞这种可读性强的:
http://58.com/bj/ershou/310976 style="color: rgb(0, 82, 255);">
画外音:北京/二手频道/帖子ID
例如:
http://api.exapmle.com/louvre/da-vinci/mona-lisa style="font-size: 15px;letter-spacing: 1px;"> 画外音:卢浮宫/达芬奇/蒙娜丽莎
方法三:多在URI的末尾添加“/”,让别人以为是目录,还有可能帮他们多搞一次301跳转,把性能搞差。 例如:
http://api.canvas.com/shapes/ style="font-size: 15px;letter-spacing: 1px;">
而这样没有歧义的api,是万万不行的:
http://api.canvas.com/shapes style="font-size: 15px;letter-spacing: 1px;">
例如:
http://api.example.com/blogs/my_first_post style="font-size: 15px;letter-spacing: 1px;text-decoration: underline;"> 怎么样,配合上下划线特效,是不是特别爽?
而这种比较清爽的,是不推荐的:
http://api.example.com/blogs/my-first-post style="font-size: 15px;letter-spacing: 1px;">
http://api.example.com/My-Folder/My-Doc style="font-size: 15px;letter-spacing: 1px;"> 画外音:RFC 3986中规定URI区分大小写。
玩笑归玩笑,好的URI,建议这么弄:
(1)RESTful是基本原则, 命名要有意义 ;
(2) 不要用容易拼错的外语 ;
(3)URI的 末尾不要添加“/” ;
(4) 使用“-”而不是“_” ,以提高URI的可读性;
(5) 禁止使用大写 。
本文转自“架构师之路”公众号,58沈剑提供。