Маршрутизация API ASP.NET

Question

Я работаю над API ASP.NET 5 и понимаю, что для того, чтобы сделать API «спокойным», насколько это возможно, мы используем глаголы Http как имена методов.

Вопрос, что произойдет, если у меня есть несколько методов, которые делают разные вещи, и все они должны быть HttpPost?

Скажите, у меня есть метод, который я могу вызвать для обновления имени пользователя и может иметь другой метод, который я использую для обновления города пользователя. В обоих случаях входными параметрами будут идентификатор пользователя (GUID) и значение, которое является строкой.

[HttpPost("id")] 
public void Post([FromRoute]id, [FromBody]firstName) 
{ 
    // Change user's first name 
} 

[HttpPost("id")] 
public void Post([FromRoute]id, [FromBody]city) 
{ 
    // Change user's city 
} 

Как назвать мои методы в этом случае?

Answer 1

Чтобы иметь 2 способа публикации, которые делают разные вещи, используйте атрибут «ActionName».

[HttpPost("id")] 
[ActionName("FirstNamePost")] 
public void FirstNamePost([FromRoute]id, [FromBody]firstName) 
{ 
    // Change user's first name 
} 

[HttpPost("id")] 
[ActionName("CityPost")] 
public void CityPost([FromRoute]id, [FromBody]city) 
{ 
    // Change user's city 
} 

Таким образом, вы могли бы назвать «www.mysite.com/api/citypost/1» или «www.mysite.com/api/FirstNamePost/1»

Другой вариант должен был бы только один post и добавьте третий параметр для различения обновления имени или обновления города.

Answer 2

вы можете дать регулятора, маршрутное preffix

[RoutePrefix("Note")] 
public class NoteController 

затем дать конкретный маршрут когда-либо действия

[Route("", Name = "Note")] 
[HttpGet] 
public async Task<IHttpActionResult> Get (string tenantName, [FromBody] TagTdo entity) 

[Route("", Name = "CreateNote")] 
[HttpPost]   
public async Task<IHttpActionResult> Post (string tenantName, [FromBody] NoteDto entity) 

[Route("Update\{id}", Name = "UpdateNote")] 
[HttpPut]   
public async Task<IHttpActionResult> Put(string tenantName, [FromBody] NoteDto entity) 

то маршрут будет:

\Note [GET] 
\Note [POST] 
\Note\Update\4 [PUT] 

также как Именование преобразования DONT использует длинное имя в маршруте, тормозит до нескольких слов со слэшем и http-глаголом

не использовать «GetUserContacts», используйте «User \ Контакты [GET]»