Перейти к содержанию

Идентификаторы

GET /ids/{type}/{id}

Отдаёт все известные номера тайтла в других каталогах по номеру в одном из них.

Параметры

имя тип обязательный по умолчанию описание
type путь да imdb · kp · tmdb · tmdb_tv · kinorium
id путь да номер в этом каталоге

Запрос

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.2/ids/kp/447301"

Ответ

{
  "imdb_id": "tt1375666",
  "kp_id": "447301",
  "tmdb_id": "27205",
  "tmdb_tv_id": null,
  "kinorium_id": "472809"
}

Поле приходит null, если номер в этом каталоге неизвестен. tmdb_id и tmdb_tv_id взаимоисключающие: заполнено ровно одно из них.

Ошибки

статус код когда
400 invalid_request type не из пяти допустимых
401 unauthorized ключ отсутствует или недействителен
404 not_found такого номера нет в базе

Примечания

404 означает «связки нет», а не «фильма не существует»: тайтл может быть известен одному каталогу и ещё не сопоставлен с остальными.

Ответ маленький и стабильный — его стоит кэшировать у себя. ETag приходит.