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

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

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

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

get/v1.5/person

Request

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

Query parameters

selectFieldsstring[]

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

notNullFieldsstring[]

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

idstring[] nullable

Поиск по ID KinoPoisk (пример: "111", "222", "!666")

movies.idstring[] nullable

Поиск по ID фильма (пример: "666", "555", "!666")

sexstring[] nullable

Поиск по гендеру (пример: Женский, Мужской)

growthstring[] nullable

Поиск по росту (пример: 170-180, 180)

birthdaystring[] nullable

Поиск по дате рождения (пример: 01.01.2000-01.01.2001, 01.01.2000)

deathstring[] nullable

Поиск по дате смерти (пример: 01.01.2000-01.01.2001, 01.01.2000)

agestring[] nullable

Поиск по возрасту (пример: 18-25, 25)

birthPlace.valuestring[] nullable

Поиск по месту рождения (пример: Москва, Санкт-Петербург)

deathPlace.valuestring[] nullable

Поиск по месту смерти (пример: Москва, Санкт-Петербург)

spouses.idstring[] nullable

Поиск по ID супруги(супруга) (пример: 111, 222)

spouses.divorcedstring nullable

Поиск по статусу развода (пример: true, false)

spouses.sexstring[] nullable

Поиск по гендеру супруги(супруга) (пример: Женский, Мужской)

countAwardsstring[] nullable

Поиск по количеству наград (пример: 1-10, 10)

profession.valuestring[] nullable

Поиск по профессии (пример: Актер, Режиссер)

movies.ratingstring[] nullable

Поиск по рейтингу фильма (пример: 1-10, 10)

movies.enProfessionstring[] nullable

Поиск по профессии в фильмах на английском (пример: actor, director)

updatedAtstring[] nullable

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

createdAtstring[] nullable

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

profession.professionIdstring[] nullable

Поиск по id профессии из справочника /v1.5/dictionary/professions (пример: 1, !2)

movies.professionIdstring[] nullable

Поиск по id профессии в фильмах из справочника /v1.5/dictionary/professions (пример: 1, !2)

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": [
    {
      "profession": [
        {
          "value": "Актер",
          "professionId": 1
        }
      ],
      "movies": [
        {
          "enProfession": "actor",
          "professionId": 1
        }
      ]
    }
  ],
  "next": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0=",
  "prev": "eyJ2Ijo3LjUsImlkIjoiNTA3ZjFmNzdiY2Y4NmNkNzk5NDM5MDExIn0="
}

Changes

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