API – Filmy

Filmový endpoint poskytuje seznam filmů z databáze DIV.cz. Výstup je stránkovaný a každý záznam obsahuje základní informace o filmu a odkaz na jeho detailní API endpoint.

Seznam filmů

/api/movie/

GET /api/movie/

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json

Stránkování

Výpis používá stránkování pomocí parametrů limit a offset.

limit – počet vrácených záznamů
offset – pozice, od které se mají záznamy načíst

Příklad další stránky:

/api/movie/?limit=10&offset=10

Odpověď obsahuje odkazy next a previous a vlastní seznam filmů v poli results.

Pole seznamu

Pole	Význam
movieid	Interní ID filmu v DIV.cz.
title	Původní název filmu.
titlecz	Český název filmu.
releaseyear	Rok uvedení filmu.
popularity	Hodnota popularity uložená u filmu.
movie_detail_link	Odkaz na detail filmu v API.

Příklad odpovědi

{
    "next": "https://div.cz/api/movie/?limit=10&offset=10",
    "previous": null,
    "results": [
        {
            "movieid": 2,
            "title": "Ariel",
            "titlecz": "Ariel",
            "releaseyear": "1988",
            "popularity": 3.2803,
            "movie_detail_link": "https://div.cz/api/movie/2/"
        },
        {
            "movieid": 11,
            "title": "Star Wars",
            "titlecz": "Hvězdné války",
            "releaseyear": "1977",
            "popularity": 38.6307,
            "movie_detail_link": "https://div.cz/api/movie/11/"
        }
    ]
}

Detail filmu

Každý záznam obsahuje odkaz na samostatný detail filmu.

GET /api/movie/<MovieID>/

Příklad:

/api/movie/11/

Přesná struktura detailního endpointu je popsána podle aktuálně publikovaných polí API.