Sign in
Актеры, режиссеры, операторы, и т.д

Награды актеров (cursor)

Награды и номинации персон по фильтрам. Доступны фильтры по nomination.id (id номинации) и nomination.award.slug (slug премии).

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

get/v1.5/person/awards

Request

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

Query parameters

limitnumber

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

nextstring

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

prevstring

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

sortFieldstring[]

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

sortTypestring[]

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

withCountboolean

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

selectFieldsstring[]

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

notNullFieldsstring[]

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

personIdstring[] nullable

Поиск по ID персоны (пример: "666", "555", "!666")

nomination.idstring[] nullable

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

nomination.award.slugstring[] nullable

Поиск по slug премии (nomination.award.slug) (пример: "oscar", "cannes")

nomination.titlestring[] nullable

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

nomination.award.titlestring[] nullable

Поиск по названию премии (пример: "Оскар", "Золотой глобус")

nomination.award.yearstring[] nullable

Поиск по году премии (пример: "2019", "2020")

movie.idstring[] nullable

Поиск по ID фильма за который вручена награда (пример: "666", "!666")

winningstring nullable

Поиск по победам (пример: "true", "false")

updatedAtstring[] nullable

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

createdAtstring[] nullable

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

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.