Доступ к ресурсу по ID#
1.
Единый формат запросов по ID:Для всех ресурсов, где идентификатор id является целым числом (integer), необходимо применять стандартный путь вида /resource/by-id/:id.
Пример для уровней: /level-stages/by-id/:id.
Пример для наград: /gifts/by-id/:id.
2.
Данное правило применяется только для ресурсов, где id представлен в виде целочисленного значения (int).
Для новых контрактов, где используется UUID, это правило не актуально.
3.
Маршрутизатор не поддерживает приоритизацию путей по паттернам или точному совпадению, что может приводить к конфликтам с путями, такими как /current. Чтобы избежать путаницы, для int-идентификаторов добавляется сегмент /by-id.
4.
С переходом на UUID 7, длина идентификатора будет всегда известна и фиксирована. Это позволит убрать лишние сегменты /by-id для новых контрактов, так как система сможет точно различать пути по длине UUID, исключая конфликты с другими маршрутами.
Правила передачи изображения#
1.
Ссылки на изображения (Url):Если название поля заканчивается на Url, это означает, что в этом поле содержится ссылка на файл.
Пример: imageUrl — содержит URL-адрес изображения.
Важно: ссылки на файлы могут передаваться только в полях, название которых заканчивается на Url. В других полях передача ссылок запрещена.
2.
Идентификаторы файлов (Id):Если название поля заканчивается на Id, это означает, что в этом поле содержится идентификатор файла.
Пример: imageId — содержит идентификатор изображения в системе.
3.
Id используется для админских интерфейсов, где нужно взаимодействовать с внутренними файлами напрямую.
Url используется для клиентских приложений, где требуется предоставить доступ к изображению через ссылку.
Modified at 2026-07-08 15:19:33
