向REST Web API传递int数组的路由内联约束异常及REST合规性咨询

问题1：int数组路由内联约束异常解决方案 #

• 异常原因：你所用的Web框架（以ASP.NET Core为例）原生路由内联约束不支持int[]类型，因此{documentTypes:int[]}的写法会直接触发约束校验异常。
• 可行处理方案：
  1. 自定义路由约束+模型绑定：自行实现IRouteConstraint接口编写int数组校验逻辑，注册后将路由改为[Route("categories/{categoryId:int}/documenttypes/{documentTypes:intArray}")]，调用URL去掉{}和[]，使用逗号分隔格式：api/categories/2/documenttypes/2,3,4,5，再配套简单的模型绑定器即可自动将路径段字符串转为int数组。
  2. 新增独立端点避免冲突：在路径中增加明确的语义段区分批量查询接口，例如路由写为[Route("categories/{categoryId:int}/documenttypes/batch")]，数组直接用查询参数传递，不需要JSON格式，重复key即可自动绑定为数组：api/categories/2/documenttypes/batch?doctypes=1&doctypes=3&doctypes=4，完全不会和返回全量的接口冲突。
  3. 单接口兼容两种场景：不拆分两个端点，仅保留api/categories/{categoryId:int}/documenttypes接口，逻辑中判断如果收到doctypes查询参数则返回指定ID的文档类型，未收到则返回全量，从根源上避免端点冲突问题。
  4. 改用POST请求：如果数组长度较长，可能触发URL长度限制，可改为POST请求将数组放在请求体中传递，仅适合非查询类的操作场景。

问题2：URL格式合规性说明 #

你提供的api/categories/2/documenttypes/{[1,3,4]}格式不符合常规的URL设计规则，和REST规范的语义建议也不匹配：

• 语法层面：{、}、[、]都属于URL保留字符，未编码直接传输会被代理、服务端识别为非法字符，导致请求失败。
• 语义层面：REST规范中路径段的核心作用是定位唯一资源，过滤类的参数建议放在查询字符串中，将过滤条件放在路径段会导致资源定位语义混淆。

内容的提问来源于stack exchange，提问作者Thierry