Distinct

Получение уникальных значений по указанному полю коллекции.

Метод полезен для построения UI-фильтров, например: список всех брендов (brand), категорий (category) или статусов (status).

API-метод Distinct недоступен для коллекций типа Пользователи.

Запрос

GET /v1/:project/:collection/distinct

Query-параметры

Параметр	Тип	Обязательный	Описание
fields	string	Да	Одно или несколько полей коллекции, по которым нужно получить уникальные значения

Пример запроса

GET https://api.kodzero.pro/v1/:project/:collection/distinct?fields=brand,category

Ответ

{
  "ok": true,
  "result": {
    "brand": ["Nike", "Adidas", "Puma"],
    "category": ["Кеды", "Кроссовки"]
  }
}

Настройки метода в коллекции

Во вкладке «Настройки API» для метода Distinct доступны:

1. Включён/Выключен — можно полностью отключить метод
2. Доступность — уровень доступа (Как у коллекции, Public, User, Workspace)
3. Ограничение полей — список полей, по которым разрешено запрашивать уникальные значения (если не установлено, разрешены все)

💡 Рекомендация

Для публичных фильтров оставляйте в ограничении полей только безопасные поля (например brand, category) и не добавляйте чувствительные данные.

Ошибки

Поле недоступно для Distinct

Если поле не входит в разрешённый список (ограничение полей), метод вернёт ошибку.

{
  "ok": false,
  "error": "<string>"
}

Метод отключён

Если метод Distinct выключен в настройках API, запрос будет отклонён со статусом 404.

{
  "ok": false,
  "error": "<string>"
}