Перейти к содержимому
Разделы: Перечисления

Значения и статистика

Перечисления

GET/v1.3/enums

Все закрытые наборы значений API с подписями на русском и английском — для типов и интерфейса.

Здесь все значения, которые API отдаёт кодом: виды тайтлов, роли, виды медиа и выходов, статусы, возрастные рейтинги. У каждого значения — подписи label_ru и label_en: берите их для интерфейса, а по value пишите код и типы.

Наборы меняются только с выходом новой версии API. Ответ можно хранить сутки — так и говорит Cache-Control: max-age=86400, — а потом сверять по ETag: ответ 304 бесплатен.

наборгде встречается
title_kindsвид тайтла kind, фильтр kind
genres, regionsжанры и группы стран, фильтры genre и region
sort_keys, presetsключи sort и пресеты каталога
list_fields, title_fields, person_fieldsимена для fields в списках, карточке тайтла и людях
statusesстатус выхода в карточке
credit_rolesроли в составе и фильмографии
image_types, video_kindstype в медиа
text_kinds, fact_kinds, faq_link_typesтексты
relation_kindsrelation в связях
release_types, release_regionsкалендарь релизов
title_release_typesдаты выхода в карточке
age_limits, mpaa_ratingsвозрастные рейтинги и фильтры age_limit, mpaa
parental_categories, parental_severitiesродительский гид в карточке
company_kindsроли компаний и фильтр company.kind
site_kinds, site_sectionsссылки «где смотреть» в карточке
rating_sourcesисточники оценок в карточке
sourcesкаталоги: imdb, kp, tmdb, kinorium
tag_kindsвиды меток Кинориума
gendersпол человека
person_relations, marriage_statusesсемья в карточке человека
zodiac_signsзнак зодиака человека
education_typesтипы учебных заведений в образовании человека

Нужны не все наборы — перечислите их в set: set=credit_roles,genres. Страны и площадки — в значениях фильтров: там же видно, сколько тайтлов у каждого значения.

Параметры запроса

  • setcsv

    Какие наборы вернуть, через запятую.

    По умолчанию:

    все

    Пример: set=credit_roles,genres
  • langru | en

    Оставить в ответе один язык. Без него текстовые поля приходят парами _ru и _en. Подробнее — Языки ответа.

    Пример: lang=en

Поля ответа

  • наборarray

    Набор значений, имя — из таблицы выше. В порядке, в котором их удобно показывать.

    Показать 3 поля
    • valuestring

      Значение, как его отдаёт API.

    • label_ru · label_enstring

      Подпись на русском и на английском.

Ошибки

статускодкогда
400invalid_request

Неизвестный набор в set — в ответе список допустимых; параметр, которого справочник не понимает (например, fields).

401unauthorized

Нет заголовка X-API-Key, ключ неизвестен или отозван.

429rate_limited

Исчерпан предел в секунду или квота на сутки.

Все коды и что с ними делать — на странице Ошибки.

Esc

Загружаем оглавление…

    ↑ ↓ выбратьEnter открытьEsc закрыть