RESTful API关联场景最佳实践：路径与请求体参数重复是否合理

两个systemId是否属于参数重复 #

确实属于重复参数。二者的业务语义完全一致，都是指向子系统归属的父系统唯一标识。
如果实际调用时两个参数值不一致，还会额外带来逻辑歧义：服务端不知道该以路径里的标识为准，还是以请求体里的标识为准，需要额外做兼容判断，反而增加了出错概率。

这种设计是否是行业通用的良好实践 #

不属于主流RESTful设计的推荐实践。
按照RESTful的资源定位逻辑，POST请求路径/v1/systems/{systemId}/subsystems本身已经明确了「要在systemId对应的父系统下创建子系统」的语义，路径参数已经完成了父资源的定位，请求体不需要再重复传systemId。
仅两种特殊场景可以保留重复参数：

• 你的接口需要兼容历史调用方，老版本调用方已经固定在请求体里传systemId，这时候可以同时保留两个参数，但必须在文档里明确约定二者不一致时的优先级，通常默认以路径参数为准
• 接口支持批量创建跨父系统的子系统，路径里的systemId作为默认归属值，请求体里的systemId可以单独指定每个子系统的归属，不过这种场景下一般会直接把接口路径改成/v1/subsystems，不需要带父资源的路径参数

如果没有以上特殊需求，直接删除请求体里的systemId字段即可，既减少冗余，也避免参数不一致带来的业务bug。

内容的提问来源于stack exchange，提问作者D. Mateescu