Как запросить данные по ключу поиска в конечной точке get

Question

Я хочу получить отфильтрованные объекты по конечной точке GET. Это должно быть сделано одним не жестко заданным параметром (например, id, name, description, ...). Я думал о сглаживании таким образом, у меня есть два параметра: searchKey и searchValue.

http://localhost:8080/api/cars?searchKey=name&searchValue=peugeot

Но это не выглядит хорошо. Каковы лучшие сценарии для этой проблемы?

Answer 1

Я лично хотел бы создать новый маршрут http://localhost:8080/api/cars/search и предоставить POST-глагол для этого маршрута. Это своего рода создание ресурса ... новый поисковый ресурс. Таким образом, в целом URL читаем и понятен + параметры поиска находятся в теле POST.

Вы можете создать отличную дискуссию о RESTful или нет ... но я думаю, что важно то, что вы и особенно ваши пользователи API любите использовать!