Быстрый старт¶

1. Ключ¶

Запросите ключ у владельца сервиса. Ключ выглядит так:

kd_live_b62a29f3…

Передавайте его в каждом запросе заголовком X-API-Key. Без него — 401.

2. Первый запрос¶

Свяжите идентификаторы одного фильма между каталогами:

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"
}

3. Карточка тайтла¶

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.2/titles/tmdb/27205?fields=title,ratings,release"

{
  "ids": {
    "imdb_id": "tt1375666",
    "kp_id": "447301",
    "tmdb_id": "27205",
    "tmdb_tv_id": null,
    "kinorium_id": "472809",
    "urls": {
      "imdb": "https://www.imdb.com/title/tt1375666/",
      "kinorium": "https://ru.kinorium.com/472809/",
      "kp": "https://www.kinopoisk.ru/film/447301/",
      "tmdb": "https://www.themoviedb.org/movie/27205"
    }
  },
  "title": {
    "title_ru": "Начало",
    "title_en": "Inception",
    "title_original": "Inception",
    "title": "Начало"
  },
  "ratings": {
    "sources": {
      "imdb": { "value": 8.8, "votes": 2866853, "scale": 10, "url": "https://www.imdb.com/title/tt1375666/" },
      "kp":   { "value": 8.7, "votes": 1127148, "scale": 10, "url": "https://www.kinopoisk.ru/film/447301/" },
      "rt":   { "value": 86.0, "votes": 364, "scale": 100, "kind": "critics" }
    },
    "votes_total": 4034156,
    "divergence_kp_imdb": 0.1,
    "popularity": 50.9672
  },
  "release": {
    "year": 2010,
    "runtime": 148,
    "releases": [
      { "region": "world", "dates": [ { "type": "premiere", "date": "2010-07-08" } ] },
      { "region": "ru",    "dates": [ { "type": "premiere", "date": "2010-07-22" },
                                      { "type": "digital",  "date": "2012-06-01" } ] }
    ]
  }
}

Блок ids приходит всегда — без него карточку не с чем связать. Остальное выбирает ?fields=: перечисленные блоки остаются, ?fields=-akas убирает один. Без параметра карточка приходит целиком — двадцать два блока, около 24 КБ.

4. Поиск¶

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.2/titles?q=начало&limit=3"

5. Каталог с фильтрами¶

Аниме из Японии с рейтингом IMDb от 8, от свежего к старому:

curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.2/titles?kind=anime&country=jp&rating_imdb.gte=8&sort=-year&limit=5"

Дальше: Соглашения — как устроены фильтры, сортировка и пагинация во всех списках сразу.