转换、计算的RESTful设计

Question

如何设计像这样的操作:

• 计算
• 转化
• 翻译

例如:从“EUR”转换为“CNY”金额“100”。

这是 /convert?from=EUR&to=CNY&amount=100 RESTful 吗？

Answer 1

什么都没有

/convert?from=EUR&to=CNY&amount=100

那不是 RESTful。您可以说这标识了一个 REST 资源。

但它看起来像基于 HTTP 的 RPC(远程过程调用)，在不像货币转换那么简单的情况下，将导致系统不是 RESTful。

总是问自己:我的资源是什么？

一个答案可能是:资源是转换结果，由两种货币和金额标识。如果你使用它会看起来更 RESTful

/conversion?from=EUR&to=CNY&amount=100

请注意，路径是名词(conversion)，而不是动词(convert)。一般来说，如果您可以用名词命名 REST 资源，那么您就走在了正确的轨道上。

如果将标识位放入查询参数 (?from=EUR&to=CNY&amount=100) 或路径中，这是一个品味问题。你可以使用

/conversion/EUR/100/CNY

使用三个路径参数:

/conversion/{FROM}/{AMOUNT}/{TO}