android - RESTful API url 最佳实践 GET 与 POST

Question

我正在尝试为 android 创建购物应用程序，因为我正在我的商店网站上构建 REST API。
我想优化并为用户带来更好的体验。
所以我的问题是产品、类别和商店其他部分的图像根据网络浏览器调整大小，因此对于移动设备来说尺寸相对较大。
所以我决定在请求中优化这个传递的当前宽度和高度。

所以我想知道执行此操作的最佳实践和 url 外观是什么。

现在我有以下网址

mysuperstore.com/api/categories/40/products/53

所以第一次安装应用程序时，图像设置保存在设备上的某个位置，然后用于使用网站 API 请求产品。

我想过这样的事情

   mysuperstore.com/api/categories/40/products/53?width=100&height=100 

但在这种情况下，宽度和高度的含义似乎很奇怪？

我也考虑过在 POST 请求中传递参数，但是 POST 请求用于在服务器上存储一些东西。

所以请建议 url 在我的情况下应该是什么样子，什么是最佳实践或这样做。

提前致谢。

Answer 1

您的网址应该显示您想要的内容。现在，您正在请求产品；因此，宽度和高度没有意义。

mysuperstore.com/api/categories/40/products/53?width=100&height=100

我想要下面网址中的产品图片；因此，宽度和高度更有意义。

mysuperstore.com/api/categories/40/products/53/image?width=100&height=100

我通常希望我的服务精简；因此，我会像下面这样设计我的服务。所有选择都将使用 GET 方法，其他服务将使用其他 HTTP 方法。

1. 最常用的产品信息

   mysuperstore.com/api/categories/40/products/53

2. 产品图片采用不同的方法；因为，与产品信息相比，图像尺寸会很大，有些客户可能不需要它。

   mysuperstore.com/api/categories/40/products/53/image?width=100&height=100

3. 其他细节或额外信息

   mysuperstore.com/api/categories/40/products/53/details

4. 当然，服务可以包含所有信息。

   mysuperstore.com/api/categories/40/products/53/all

5. 正如您在问题中所说，POST/PUT/DELETE 方法将保留用于更新产品信息。

通过这种设计，我的客户将有选择的余地。大多数时候会用到正常的产品服务和产品图片服务。最少使用的信息不会在网络中传播。