Api Url 部件命名法

Question

我有一个类似的 api
http://api.mycompany.com/products/bycategory/{category_id}
结尾部分如何/products/bycategory/{category_id}被称为？例如，如果我删除域部分，如果我把它放在 web.config 中，我该如何命名其余部分？

网址？我看了一些文章，但我很困惑。有时完整的 Url 似乎是其他提到的剩余部分的 URI。

谢谢。

Answer 1

一个 URL由以下部分组成:

协议(protocol)，例如 http://

域，例如 api.mycompany.com

路径，例如 /products/bycategory/{category_id}

可能是查询字符串，例如 ?key=value&otherKey=otherValue

如何解释路径和查询字符串取决于服务器。一个简单的 Web 服务器可能只提供路径指向的文件。应用服务器可以将路径解释为查询。

REST resource naming guide谈论“资源”，这是有道理的，因为首先一个 URL 是-a uniform resource identifier (URI)。 URI 也使用术语“路径”。

见 this question on REST API naming guidelines及其答案，那里使用的术语也是“路径”。

我也会使用“路径”。