Плюсы / минусы передачи идентификатора записи через URL в сравнении с параметром

Question

Я работаю над API, и мне интересно, есть ли какие-либо преимущества / недостатки доступа к записи путем передачи идентификатора через URL-адрес по сравнению с параметром.

Пример: получение информации о сообщении с идентификатором 1

Вы могли бы сделать это с example.com/messages/1 который вернул бы сообщение с идентификатором 1 в формате JSON.

Или вы могли бы сделать example.com/messages?id=1,

Есть ли какие-то причины выбирать один из них или это будут личные предпочтения?

Answer 1

Ваш предыдущий пример немного более читабелен и интуитивно понятен. Разработчикам будет легче работать с обеими сторонами API. Это также намного более стандартно для веб-API. Большинство платформ предназначены для поддержки URL-адресов в обеих формах. При прочих равных условиях первый пример, вероятно, лучше.