Что такое хорошая практика для реализации сложных вызовов REST?

Question

В настоящее время я программирую REST API, используя Node.js, который вычисляет билайн между двумя географическими координатами. Чтобы рассчитать результат, мне нужны следующие 4 параметра:

• start_lon
• start_lat
• end_lon
• end_lat

Итак, мой вызов должен выглядеть так:

http://hostname/beeline/{start_lon}/{start_lat}/{end_lon}/{end_lat}

или больше как это:

http://hostname/beeline?start_lon={start_lon}&start_lat={start_lat}&end_lon={end_lon}&end_lat={end_lat}

Answer 1

Как вы сказали, у вас есть 4 параметры для расчета билайна. Тогда вы будете использовать параметры HTTP-запроса к ресурсу beeline. Тогда:

http://hostname/beeline?start_lon={start_lon}&start_lat={start_lat}&end_lon={end_lon}&end_lat={end_lat}

Таким образом, параметры изменяют способ доступа к ресурсу beeline.

Answer 2

Я бы пошел с последним, потому что нет никакой иерархической взаимосвязи между параметрами (в отличие, например, от / images / 123, где номер изображения 123 находится «под», в иерархическом смысле, в папке «images»)