20 | 请求路径构建（上）：如何设置RESTful API接口路径？

1. REST接口规范中的URI设计规范包括资源名使用名词复数表示，URI路径使用小写，避免层级过深的URI，以及将操作变成资源的一个属性或将操作当作是一个资源的嵌套资源。 2. RESTful API使用HTTP协议原生的`GET`、`PUT`、`POST`、`DELETE`来标识对资源的CRUD操作，同时还提供了其他请求方法，如`OPTIONS`，并且在使用HTTP方法时需要注意返回结果的可用性和对资源进行状态/属性变更时要使用`PUT`方法。 3. 统一的返回格式和API版本管理是RESTful API设计中的重要内容，统一的返回格式可以减少用户的学习和使用成本，而API版本管理可以保证新老版本共存，满足新需求。 4. API版本标识可以放在URL中、HTTP Header中或Form参数中，通常建议将版本标识放在URL中，但根据项目实际需要选择一种方式即可。 5. 请求路径的构建比较复杂，需要深入理解kube-apiserver RESTful API接口请求路径构建方式。 6. 资源都是使用URI标识的，应该规范化设计URI，让API接口更加易读、易用。 7. RESTful API接口由请求方法、请求路径和请求参数构成，请求方法可以在发送HTTP请求时直接指定，请求参数也可以直接通过HTTP请求来设置。 8. 在设计URI时，如果遇到一些不确定的地方，推荐参考REST接口规范中的URI设计规范。 9. Kubernetes的RESTful API接口路径设计基于资源类型、分组和版本三要素共同构建，通常格式为`/{API接口前缀}/{API版本}/{API分组}/{资源种类}`。 10. Kubernetes的路径设计引入Group-Version-Resource (GVR)三元组概念，采用「资源组优先+多版本共存」结构，严格遵循REST规范，保证资源可管理性并提供清晰API扩展框架。