创建用于添加新项目的Web REST API的标准是什么

Question

我有一个订单目录网站，我想创建一个REST API，以便人们可以创建自己的应用程序并添加订单或更新现有订单：

让我们说订单有：

1. 的OrderId
2. 产品
3. 数量
4. ShippingType

所以我需要一些API来允许某人发送新订单（orderid将是空白的，因为它会在响应中）。

1. 如何处理传递产品或运输类型等项目。这些是我的数据库中的表，并且键入了他们自己的特定主键ID。如果NewOrder API要求这些字段的字符串名称，它是否应该要求id。如果它要求提供ID，那么就会假设他们必须预先调用GiveMeProductList（）方法（这会将所有产品的名称和ID作为数据集）。

处理此问题的标准是什么？

Answer 1

Martin Fowler有一篇关于steps toward the glory of REST的好帖子，你可能会发现它对于提出REST API很有用。

Answer 2

我用于将此信息发送到服务器的媒体类型可以处理两种情况，Id和代码/名称。如果用户手动输入产品代码，那么我发送代码，如果用户要求从列表中选择，那么我提供列表并发回ID。