Плохо ли ставить точку в пути URI?

Question

Я разрабатываю REST API для веб-приложения. Я хочу четко определить версию API, чтобы интерфейс мог быть изменен в будущем, не нарушая существующие сервисы. Поэтому в моем API v1.0 я хочу четко определить его как API v1.0, оставляя мне свободу выпускать будущую версию v1.1 с серьезными изменениями.

Мой вопрос: будет ли точка в компоненте пути URI плохой практикой?

например. Есть ли веская причина не использовать http://example.com/myapi/v1.0/services в качестве URI для моего сервиса?

Answer 1

Ввод точки в URI - это прекрасно. Ввод номера версии в URI определенно не является наилучшей практикой.

Здесь - мои причины, и здесь - хорошая статья на эту тему, написанная кем-то намного умнее меня.

Answer 2

это абсолютно правильный путь, см. Стр. 27 спецификации http://www.ietf.org/rfc/rfc2396.txt

Нет причин не использовать его

Answer 3

Вполне допустимо использовать точку в пути URI.Это также действует в соответствии с RFC 3986 раздел 2.3 .

Answer 4

Я думаю по-другому о других ... Я не думаю, что это хорошая практика использовать его в URL.

ИМХО, намного лучше, если вы используете версию для заголовка Content-Type.

Например, если вы используете application / xml:

Тип содержимого: application / v1.0 + xml.

Использование Content-Type также указывает, что сам ресурс является версионным. Хотя, если вы используете его в URL, вам кажется, что вы работаете с сервисом (что не так), и если вы меняете сам сервис, вы, вероятно, измените URL, поэтому вам не нужна версия число.

РЕДАКТИРОВАТЬ: Вы также должны использовать его в заголовке Accept, а не только в типе контента.

Answer 5

Я думаю, что это хорошая идея. Я видел несколько служб отдыха, которые делают это.