Тексты

GET/v1.3/titles/{type}/{id}/texts

Факты, вопросы с ответами и цитаты о тайтле.

Без параметров тексты приходят разделами: факты, вопросы и ответы, цитаты. counts — сколько текстов каждого вида у тайтла, при любом kind: по нему подписываются вкладки.

Тексты сейчас только на русском: поля _en равны null. С lang=en текст придёт пустым — так видно, что перевода ещё нет.

У «Матрицы» сюжет раскрывает каждый четвёртый факт. Чтобы показывать факты рядом с описанием, уберите спойлеры: spoilers=false.

Параметры пути

• typestringобязательный

  Каталог, из которого ID: IMDb, Кинопоиск, TMDB (фильм или сериал) или Кинориум.

  imdbkptmdbtmdb_tvkinorium
• idstringобязательный

  ID в этом каталоге. У IMDb — tt и цифры (tt1375666), у остальных — цифры (447301).

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

• kindcsv

  Виды текстов, через запятую. Подписи — в /enums, набор text_kinds.

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

  все три

  Пример: kind=quote
• spoilersboolean

  false — убрать факты, которые раскрывают сюжет.

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

  со спойлерами

  Пример: spoilers=false
• fact_kindcsv

  Подвиды фактов, через запятую. Подписи — в /enums, набор fact_kinds.

  generaltriviablooper
  Пример: fact_kind=blooper
• groupenum

  Разбить список на разделы. none — плоский список. Как устроены разделы — в Списки и пагинация.

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

  kind

• langru | en

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

  Пример: lang=en
• limitinteger

  Сколько элементов вернуть, целое от 1. В разделах — на каждый раздел, до 50. В плоском списке — до 1000. Больше потолка — не ошибка: API срежет до него и покажет в limit.

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

  10 в разделе, 1000 в плоском списке

  Пример: limit=20
• offsetinteger

  Сколько элементов пропустить, целое от 0. Только в плоском списке: с разделами — 400.

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

  0

Поля ответа

• countsobject

  Сколько у тайтла фактов, вопросов и цитат: fact, faq, quote.

• itemsarray

  Тексты. Набор полей зависит от вида — kind. В разделах — разделы со своими total и подписями.

  +−Показать 17 полей

  • kindenum

    Вид: fact, faq или quote.

  • text_ru · text_enstring | null

    Факт или цитата.

  • fact_kindenum

    Подвид факта: general — факт, trivia — интересный факт, blooper — киноляп.

  • is_spoilerboolean

    Факт раскрывает сюжет. false — источник его так не пометил.

  • ordinteger

    Порядок факта у источника.

  • question_ru · question_en · answer_ru · answer_enstring | null

    Вопрос и ответ.

  • linksarray

    Кто упомянут в ответе: text — как написано, type и ID с именем, как у человека в составе.

  • original · original_langstring | null

    Цитата на языке оригинала и этот язык, ISO 639-1.

  • author_ru · author_enstring | null

    Кто произносит цитату — актёр.

  • author_role_ru · author_role_enstring | null

    Персонаж, которому принадлежит цитата.

• total · limit · offset · has_more

  Пагинация — как в любом списке.

Ошибки