Коллекции

Коллекция — это набор записей одной формы. Её имя становится сегментом пути, а схема описывает поля записей.

Что появляется вместе с коллекцией

Одним действием создаются сама коллекция, пять маршрутов над ней и, если указать число, стартовые записи.

Имя коллекции

Имя попадает в адрес, поэтому оно должно быть уместно в URL: латиница, цифры и дефис. Обычно это множественное число — users, orders, tickets.

Маршруты не дублируются

В одном проекте не может быть двух маршрутов с одинаковыми методом и путём. Попытка завести такой маршрут отвечает 409: иначе запросы всегда обслуживал бы первый из них, а второй никогда бы не срабатывал.

Схема не проверяет данные

Схема нужна для двух вещей: по ней генерируются значения и по ней проверяются имена полей в фильтрах. Форму записей она не ограничивает — запись, отправленная через POST с лишними или недостающими полями, сохранится и вернётся как есть.

Поэтому в числовом поле одной записи может оказаться строка. Запрос от этого не сломается: такая запись просто не попадёт в выборку по числовому фильтру.