Спецификация API v1.0

Базовый url: https://yupest2.pythonanywhere.com/
Чтобы получить данные через API, нужно составить запрос:
Базовый URL + Адрес API (или эндпоинты) + Параметры запросов
Например: https://yupest2.pythonanywhere.com/api/v1.0/movies/524
В этом примере параметр <code> был заменен на значение 524.
Количество фильмов и Количество записей могут быть не равны, так как один фильм представляется записями по каждому жанру

Предложенный интерфейс предназначен для вывода информации о фильмах и предлагает набор следующих функций:

Получить фильм

Возвращает записи фильма по коду <code>, если фильма с <code> не существует, выводит сообщение: Фильм не найден.. При <code> = 0 возвращает случайный фильм.

Адрес API

GET /api/v1.0/movies/<code>/

Параметры

Параметр	Тип	Описание
`code`	int	Код фильма

Ответ

JSON-объект со следующей структурой:

{'code' : Код фильма (int),
'count_records' : Количество записей (int),
'records' : [
        {
          "code": код фильма (int), 
          "Бюджет ($)": (float), 
          "Возраст": Возврастное ограничение (str), 
          "Время (мин.)": Длительность (int), 
          "Год производства": (int), 
          "День выхода": День недели (str), 
          "Десятилетие": (int), 
          "Жанр": (str), 
          "Количество оценок на IMDb": (int), 
          "Количество оценок на Кинопоиск": (int), 
          "Название": (str), 
          "Премьера в мире": Дата (str), 
          "Прибыль ($)": (float), 
          "Режиссер": (str), 
          "Сборы в России ($)": (float), 
          "Сборы в США ($)": (float),  
          "Слоган": (str), 
          "Средняя оценка": По 10-балльной шкале (float), 
          "Средняя оценка на IMDb": По 10-балльной шкале (float),  
          "Средняя оценка на Кинопоиск": По 10-балльной шкале (float),  
          "Страна": (str)
        },
        ...
    ]
}

Получить фильмы

Возвращает фильмы по указанным параметрам: с учетом жанра <genre> и/или с учетом страны <country>. Если таких фильмов нет, выводит: Записи не найдены

Адрес API

GET /api/v1.0/movies/

Параметры

Параметр	Тип	Описание
`genre`	str	Жанр или жанры через “,” из списка `/genres`
`country`	str	Страна производства или страны через “,” из списка `/countries`

Ответ

JSON-объект со следующей структурой:

{"count_movies" : Количество фильмов (int),
"count_records" : Количество записей (int),
"country" : Страны (list),
"genre" : Жанры (list),
"records" : [
        {
          "code": код фильма (int), 
          "Бюджет ($)": (float), 
          "Возраст": Возврастное ограничение (str), 
          "Время (мин.)": Длительность (int), 
          "Год производства": (int), 
          "День выхода": День недели (str), 
          "Десятилетие": (int), 
          "Жанр": (str), 
          "Количество оценок на IMDb": (int), 
          "Количество оценок на Кинопоиск": (int), 
          "Название": (str), 
          "Премьера в мире": Дата (str), 
          "Прибыль ($)": (float), 
          "Режиссер": (str), 
          "Сборы в России ($)": (float), 
          "Сборы в США ($)": (float),  
          "Слоган": (str), 
          "Средняя оценка": По 10-балльной шкале (float), 
          "Средняя оценка на IMDb": По 10-балльной шкале (float),  
          "Средняя оценка на Кинопоиск": По 10-балльной шкале (float),  
          "Страна": (str)
        },
        ...
    ]
}

Получить жанры

Возвращает список жанров

Адрес API

GET /api/v1.0/movies/genres/

Ответ

JSON-объект со следующей структурой:

{'count_records' : Количество жанров (int),
 'records' : Список жанров (list)}

Получить страны

Возвращает список стран кинопроизводства

Адрес API

GET /api/v1.0/movies/countries/

Ответ

JSON-объект со следующей структурой:

{'count_records' : Количество стран (int),
 'records' : Список стран (list)}