是否存在关于何时应使用 URL 路径参数以及何时应使用查询参数的经验法则?
假设我有一张发票表,其中包含以下字段:company(PK)、InvoiceNo(PK)、Invoiceline、invoiceValue、noOfLines、salesPerson
我目前的想法是你的网址应该是这样的
/Invoice/
这将显示所有发票
/Invoice/{company}
这将显示公司的所有发票。
/Invoice/{company}/{InvoiceNo}
显示该特定发票和
/Invoice/{company}/{InvoiceNo}?invoiceLineNo=23
仅显示第 23 行。
我的想法是,主键字段应该是路径的一部分,而您要过滤的任何其他字段都是查询参数的一部分。
这听起来像是区分两者的合理方式吗?
我个人的经验法则是 PathParam 导致您请求的实体类型。
/Invoices // all invoices
/Invoices?after=2011 // a filter on all invoices
/Invoices/52 // by 52
/Invoices/52/Items // all items on invoice 52
/Invoices/52/Items/1 // Item 1 from invoice 52
/Companies/{company}/Invoices?sort=Date
/Companies/{company}/Invoices/{invoiceNo} // assuming that the invoice only unq by company?
去引用Mr Rowe https://stackoverflow.com/users/396747/gary-rowe: 用于分组数据的路径参数,用于过滤的查询参数
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)