hackmovie / api
CATALOG API · V1

Метаданные для медиакаталога

Небольшой открытый справочник фильмов. Получайте названия, годы выпуска и жанры в JSON для каталогов, подборок и интерфейсов.

Публичные методы доступны без ключа и поддерживают только чтение. Видеофайлы и ссылки для просмотра не предоставляются.

Первый запрос

Ответ в UTF-8, тип содержимого application/json.

curl https://api.hackmovie.ru/v1/catalog
Нажмите кнопку, чтобы получить каталог.

Структура ответа

{
  "version": "1.0",
  "total": 12,
  "items": [
    {
      "id": "arrival-2016",
      "title": "Прибытие",
      "original_title": "Arrival",
      "year": 2016,
      "genres": ["science-fiction", "drama"]
    }
  ]
}

Поле id стабильно внутри версии API. Порядок записей не является рейтингом.

Методы

ЗапросОписаниеОтвет
GET /v1/catalogВсе записи каталога200 · JSON
GET /healthДоступность API200 · JSON
GET /openapi.jsonОписание формата и методов200 · JSON

Кеширование и ошибки

Каталог можно кешировать на пять минут. Используйте заголовки ETag и Last-Modified для повторных запросов. Неизвестные пути возвращают 404. Изменяющие запросы не поддерживаются.