Премии и кинофестивали

Поиск премий и фестивалей (cursor)

Список премий/кинофестивалей (Оскар, Канны, ...) по фильтрам. В ответе придут поля указанные в selectFields (если не указать — все поля).

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

get/v1.5/award

Request

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

Query parameters

selectFieldsstring[]

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

notNullFieldsstring[]

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

idstring[]

Поиск премии по числовому id (пример: 1, !15)

slugstring[]

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

namestring[]

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

alternativeNamestring[]

Поиск премии по альтернативному названию (пример: "Academy Awards")

typestring[]

Поиск по типу премии (пример: "award", "festival")

years.startstring[]

Поиск по году начала проведения (пример: "1929", "1900-2000")

years.endstring[]

Поиск по году окончания проведения (пример: "2026", "2000-2026")

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

{
  "docs": [
    {
      "id": 1
    }
  ],
  "next": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0=",
  "prev": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0="
}

Changes

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