Перечисления
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_kinds | type в медиа |
text_kinds, fact_kinds, faq_link_types | тексты |
relation_kinds | relation в связях |
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,genreslangru | enОставить в ответе один язык. Без него текстовые поля приходят парами
_ruи_en. Подробнее — Языки ответа.Пример:lang=en
Поля ответа
наборarrayНабор значений, имя — из таблицы выше. В порядке, в котором их удобно показывать.
Показать 3 поля
valuestringЗначение, как его отдаёт API.
label_ru · label_enstringПодпись на русском и на английском.
Ошибки
| статус | код | когда |
|---|---|---|
| 400 | invalid_request | Неизвестный набор в |
| 401 | unauthorized | Нет заголовка |
| 429 | rate_limited | Исчерпан предел в секунду или квота на сутки. |
Все коды и что с ними делать — на странице Ошибки.