Коллекции кино

Универсальный поиск с фильтрами (cursor)

Поиск коллекций кино по фильтрам. В ответе придут поля указанные в selectFields (если не указать — дефолтные поля).

Используется курсорная пагинация: для следующей страницы передайте next из ответа. Листайте, пока hasNext не станет false.

get/v1.5/list

Request

  • Base URL: https://api.poiskkino.dev
  • URL: https://api.poiskkino.dev/v1.5/list
  • Auth: API key in header X-API-KEY

Query parameters

selectFieldsstring[]

Список полей требуемых в ответе из модели

notNullFieldsstring[]

Список полей которые не должны быть null или пусты

slugstring[] nullable

Поиск slug (пример: "!top250", "top250")

categorystring[] nullable

Поиск по категории (пример: "Фильмы", "!Фильмы")

moviesCountstring[] nullable

Поиск по количеству фильмов (пример: "1-200", "10")

updatedAtstring[] nullable

Поиск по дате обновления в базе (пример: 01.01.2020, 01.01.2020-31.12.2020)

createdAtstring[] nullable

Поиск по дате добавления в базу (пример: 01.01.2020, 01.01.2020-31.12.2020)

limitnumber

Количество элементов на странице

nextstring

Курсор для получения следующей страницы. Берётся из поля next в ответе предыдущего запроса. При первом запросе не передавайте этот параметр.

prevstring

Курсор для получения предыдущей страницы. Берётся из поля prev в ответе предыдущего запроса.

sortFieldstring[]

Поле для сортировки

sortTypestring[]

Тип сортировки (пример: "1", "-1")

withCountboolean

Включить подсчёт общего количества документов. Внимание: может значительно замедлить запрос при использовании фильтров на больших коллекциях.

Response

limitnumber required

Количество результатов на странице

nextstring nullable

Значение курсора для получения следующей страницы. Чтобы получить следующую страницу, передайте это значение в query-параметр next. Если значение null, значит вы достигли конца списка.

prevstring nullable

Значение курсора для получения предыдущей страницы. Чтобы получить предыдущую страницу, передайте это значение в query-параметр prev. Если значение null, значит вы на первой странице.

hasNextboolean required

Флаг наличия следующей страницы. Если true — передайте значение поля next в query-параметр next для получения следующей страницы.

hasPrevboolean required

Флаг наличия предыдущей страницы. Если true — передайте значение поля prev в query-параметр prev для получения предыдущей страницы.

totalnumber nullable

Общее количество документов по запросу. Возвращается только при withCount=true. Внимание: подсчёт может значительно замедлить запрос на больших коллекциях с фильтрами.

Example response

{
  "next": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0=",
  "prev": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0="
}

Changes

No recorded changes to this operation across all 1 revision of this API.