Локализация REST slug. Должен ли я помещать переводы в слизню?

Question

Если мои успокоительные URL-адреса выглядеть следующим образом:

http://example.com/en/city/Boston

http://example.com/de/stadt/Boston

или как это:

http://example.com/en/city/Boston

http://example.com/de/city/Boston

Answer 1

Правило, часто выступающее за API REST, заключается в том, что каждый ресурс должен иметь ровно один URI и что HTTP-заголовки должны использоваться для согласования того, как к нему нужно обращаться или манипулировать. Тем не менее, есть место для обсуждения того, как вы определяете, что представляет собой отдельный ресурс, и что представляет собой просто другое представление этого ресурса.

В вашем примере можно утверждать, что каждый город является ресурсом, но переводы данных об этом городе представляют собой представление. Это предполагает, что URL всегда должен быть http://example.com/city/boston, с выбранным языком, используя заголовок HTTP Accept-Language.

Альтернативная интерпретация заключается в том, что на самом деле вы представляете несколько API-интерфейсов, каждая из которых локализована целиком, поэтому http://example.com/en/ является базовым URL-интерфейсом API для английского языка, а http://example.com/de/ является базовым URL-адресом для API-интерфейса Германии, который, как представляется, обеспечивает аналогичный доступ к те же ресурсы. Это означает, что два API не нужно синхронизировать и могут быть адаптированы к их предполагаемой аудитории; в частности, он предположил бы, что http://example.com/de/stadt/Boston был лучшим URL-интерфейсом в немецком API.

Помните также, что имена самих ресурсов могут иметь локализованные эквиваленты, а не только такие типы ресурсов, как «город», поэтому, если города действительно были вашим типом вашего ресурса, http://example.com/en/city/Vienna будет соответствовать http://example.com/de/stadt/Wien. Это аккуратно понятное для человека, но может оказаться сложным встраивание в базовую модель данных.

Если ваше намерение состоит в том, чтобы представить один и тот же контент на максимально возможном количестве языков, то удаление локали из URL целиком и использование согласования контента через Accept-Language будет выглядеть более «RESTful». Если у вас есть отдельный английский и немецкий рынок, который может не требовать того же контента и функциональности, локализация URL-адресов, похоже, имеет смысл.

Answer 2

Там нет такого понятия, как RESTful URL. Оба набора URI полностью действительны. Выберите, что лучше для вашей серверной платформы. Я предполагаю, что это будет второй.