REST API — как реализовать несколько методов с одинаковым именем, но с разными допустимыми типами параметров

Основная маршрутизация ASP.Net использует приоритет при выборе маршрутов, обычно от более конкретного к общему. Следовательно, если у вас есть два маршрута, один с {id:int}, а другой без какого-либо квалификатора или квалификатора :alpha, тогда, если вы отправите вам int, {id:int} будет удален, иначе другой более общий маршрут будет быть пораженным. Это означает, что эти два маршрута могут сосуществовать и будут делать то, что вы хотите:

[HttpGet("something/{id:int}")]
public IActionResult Get1(int id)
{
    return Ok();
}

[HttpGet("something/{id}")]
public IActionResult Get2(string id)
{
    return Ok();
}

Вы можете проверить вызов этих двух точек с помощью почтальона или любого http-клиента. Ошибка, с которой вы столкнулись, вероятно, связана с тем, что swagger не может генерировать документацию, в которой говорится что-то вроде этого: Conflicting method/path combination Это не имеет ничего общего с ядром asp.net, а swaggerм.

Что вы можете сделать, так это игнорировать тот, который берет {id:int} из чванства, поскольку он менее общий. Вы можете использовать : [ApiExplorerSettings(IgnoreApi = true)] для этого. Как только вы это сделаете, если вы откроете swagger, вы увидите одну конечную точку, но если вы попробуете это с int, вы попадете в конечную точку {id:int}, в противном случае вы попадете в конечную точку {id}.

Я имел в виду, используя [FromQuery], вот что. Вам потребуется класс с идентификатором и именем

public class UserFilter
{
    public int? Id { get; set; }
    public string Name { get; set; }
}

Тогда проложите такой маршрут

[HttpGet]
public async Task<IActionResult> Get([FromQuery] UserFilter filter)
{
    if (filter.Id.HasValue)
    {
        // Search by id
    }
    else if (!string.IsNullOrWhiteSpace(filter.Name))
    {
        // Searh by name
    }
    return BadRequest();
}

[HttpGet]
[Route("api/controller")]
public async Task<IHttpActionResult> Get([FromQuery]string parameter)
{
    if (!string.IsNullOrEmpty(parameter))
    {
        if (int.TryParse(parameter, out int id))
        {
            // Logic to retrieve data based on the ID asynchronously
            // Example: var data = await repository.GetDataByIdAsync(id);
            // return Ok(data);
        }
        else
        {
            // Logic to retrieve data based on the name asynchronously
            // Example: var data = await repository.GetDataByNameAsync(parameter);
            // return Ok(data);
        }
    }

    // Handle invalid or missing parameter
    return BadRequest("Invalid parameter.");
}

В этом обновленном примере метод GetData принимает один параметр параметра строкового типа. Он проверяет, не является ли параметр нулевым или пустым. Если он не пуст, он пытается проанализировать его как целое число, используя int.TryParse(). Если синтаксический анализ прошел успешно, он обрабатывает параметр как идентификатор и выполняет логику для извлечения данных на основе идентификатора. Если синтаксический анализ не удается, он обрабатывает параметр как имя и выполняет логику для извлечения данных на основе имени.

Примеры конечных точек:

По целому числу:

GET /api/controller?parameter=123

По строке:

GET /api/controller?parameter=SOMENAME