给定 REST 资源的属性是否应该具有一致的顺序？

【问题标题】：Should the properties of a given REST resource have a consistent order?给定 REST 资源的属性是否应该具有一致的顺序？
【发布时间】：2016-08-26 19:51:19
【问题描述】：

RESTful GET 对给定资源 should be idempotent 的请求：相同的请求应始终返回相同的结果。

这里如何定义“相同”——无论顺序如何，具有相同属性的文档是否相同？还是我需要在返回之前规范化我的响应正文？

【问题讨论】：

我不确定实现是否相关，但我正在响应正文中使用 JSON。

标签： rest api document canonicalization idempotent

【解决方案1】：

对给定资源的 RESTful GET 请求应该是幂等的：相同的请求应该总是返回相同的结果。

在 HTTP 中，GET 对给定资源的请求应该是safe，也就是说它是只读的，这是微弱的幂等性。

no-op(X) === X

therefore

no-op(no-op(X)) === no-op(X)
QED.

Safe 和 idempotent 描述了请求对服务器的副作用；它们不会以任何方式限制资源返回的表示形式。

例如，Online UUID Generator Tool 资源每次向其发送 GET 请求时都会返回一个具有不同内容的 html 页面。请求是安全的（它不会修改资源），因此是幂等的，即使返回的表示不是稳定。

【讨论】：