最佳实践 C# REST API

Question

我们正在开发一个 REST API，并且我们允许所有四个标准动词。在 POST/PUT 的情况下 最佳实践 c# rest api 有什么更好的。

这是我的模特

public class UserModel
{
    public Int64 ID { get; set; }
    [Display(Name ="First Name")]
    public string FirstName { get; set; }
    [Display(Name="Last Name")]
    public string LastName { get; set; }
    public string Address { get; set; }
    [Display(Name="User Name")]
    public string UserName { get; set; }
    public string Email { get; set; }
    public string Password { get; set; }
    [Display(Name ="Added Date")]
    public DateTime AddedDate { get; set; }
}

示例 1

[HttpPost]
public ActionResult CreateEditUser(UserModel model)
{
    if (model.ID == 0)
    {
        User userEntity = new User
        {
           //....
         }
   }
}

示例 2

[HttpPost]
public ActionResult CreateEditUser(int id,UserModel model)
{
    if (id == 0)
    {
        User userEntity = new User
        {
            //.....
         }
     }
 }

示例 1 和示例 2 哪个更好

Answer 1

根据 REST 指南 (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md)

PUT：替换对象，或创建命名对象（如果适用）

POST：根据提供的数据创建新对象，或提交命令

PATCH：对对象应用部分更新

在您的情况下，最好将端点拆分为 POST 和 PUT。

[HttpPost]
public ActionResult CreateUser(UserModel model) 
{
    userService.Create(model);
    return...
}

[HttpPut]
public ActionResult EditUser(UserModel model)
{
    userService.Update(model);
    return...
}