Sign in
Номинации премий

Поиск номинаций (cursor)

Список номинаций (категорий: Лучший фильм, Лучшая женская роль, ...) по фильтрам. Чтобы получить номинации конкретной премии за год — задайте award (slug премии) и years (год). В ответе придут поля указанные в selectFields (если не указать — все поля).

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

get/v1.5/nomination

Request

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

Query parameters

selectFieldsstring[]

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

notNullFieldsstring[]

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

nominationIdstring[]

Поиск номинации по id (nominationId) (пример: "1839", "!1839")

awardstring[]

Поиск номинаций по slug премии (пример: "oscar", "cannes")

namestring[]

Поиск номинации по названию (пример: "Лучший фильм", "Лучшая женская роль")

yearsstring[]

Поиск по году вручения номинации (пример: "2020" или диапазон "2010-2020"). Совпадает, если год входит в массив years.

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.