Export filmů

Změněno 2020/11/20 08:30 od Jaroslav Juřica — Kategorizován jako: Nekategorizované

Export filmů s rozšířenými informacemi podle objednávek. Export se provádí od aktuálního data. Odkaz s exportem je dostupný přes menu Objednávky -> Export filmů. Export je možné zavolat kdykoliv na přidělené adrese ve formátu

https://www.disfilm.cz/api/ordered-films?key=aqkwElopmnbvSjWKELymSklWEIp

kde parametr key je klíč přidělený konkrétnímu kinu. Tento klíč je konstantní a jeho hodnota se nemění. Exportuje se program od aktuálního data dopředu.

Validační schéma souboru ORDEREDFILMS.XSD
http://www.disfilm.cz/xsd/orderedfilms.xsd - export objednaných filmů dodržuje strukturu dle daného schématu

Vzorový soubor ORDEREDFILMS.XML
http://www.disfilm.cz/xsd/orderedfilms.xml - vzorový soubor exportu objednaných filmů

Element EXPORT- hlavička souboru
Element EXPORT definuje parametry exportu. Element je povinný, v exportním souboru se může vyskytovat pouze jednou. Povinné položky jsou označené červeně.

Položka	Popis položky
code	Kód kina dle specifikace UFD
cinema	Název a místo kina pro kontrolu
exportDate	Datum a čas exportu ve tvaru YYYY-MM-DDTHH:MM:SS
status	status exportu (možné stavy jsou: Succes = úspěšně provedený export, Warning = úspěšně provedený export s varováním, Error = chyba exportu, CriticalError = interní chyba požadavku)
statusMessage	Doplňující zpráva ke statusu exportu

Element FILM - jednotlivý objednaný film
Element FILM definuje jednotlivé objednané filmy.

Položka	Popis položky
fcode	Číslo filmu
title	Titul filmu
titleOrig	Originální titul filmu
price	Cena představení
length	Délka filmu v minutách
genre	Žánr filmu (více žánrů je odděleno čárkou)
country	Země původu (více položek je odděleno čárkou)
rating	Přístupnost (výběr z předdefinovaných hodnot 0, 7, 12, 15, 18)
director	Režisér
writer	Scénář
cast	Hrají
camera	Kamera
slogan	Slogan
synopsis	Synopse
description	Obsah filmu
trailer	Youtube trailer (obsahuje pouze kód videa)
csfd	Odkaz filmu na ČSFD
imdb	Odkaz filmu na IMDb
www	Odkaz na www stránky filmu
slider	odkaz na fotografii ve vyšším rozlišení pro zobrazení ve slideru
poster	odkaz na plakát v JPG
photos	odkazy na fotografie k filmu (obsahuje elementy PHOTO)
formatLanguages	výčet objednaných kombinací formátu/jazykové úpravy (obsahuje elementy FORMATLANGUAGE)

Element PHOTO - jednotlivá fotografie události
Element PHOTO definuje jednotlivé fotografie události.

Položka	Popis položky
thumbnail	náhled fotografie (rozlišení 600x400)
fullsize	originál fotografie v plném rozlišení (obyvkle rozlišení 1280 k poměru v šířce)

Element FORMATLANGUAGE - jednotlivé kombinace formátu/úpravy
Element FORMATLANGUAGE definuje jednotlivé kombinace formátu a jazykové úpravy.

Položka	Popis položky
format	Formát projekce (výběr z předdefinovaných hodnot, viz čísleník formátů).
language	Jazyková úprava (výběr z předdefinovaných hodnot, viz číselník úprav).

Číselník formátů

Položka	Popis položky
Analog	analogový 35mm
DVD	DVD disk
DCI2D	2D
DCI3D	3D
DCI2DA	2D ATMOS
DCI3DA	3D ATMOS
IMAX	IMAX (zachováno kvůli zpětné kompatibilitě, nově se používá specifičtější IMAX2D nebo IMAX3D)
IMAX2D	IMAX 2D
IMAX3D	IMAX 3D
BLURAY	Blu-ray disk
PC	MP4
HFR2D	HFR 2D
HFR3D	HFR 3D
4DX2D	4DX 2D
4DX3D	4DX 3D
SSC2D	Superscreen 2D
SSC3D	Superscreen 3D
DBX2D	D-BOX 2D
DBX3D	D-BOX 3D
DBX2DA	D-BOX 2D ATMOS
LIVE	živý přenos

Číselník jazykových úprav

Položka	Popis položky
CZ	Česká verze
CD	Česká verze/dabing
SK	Slovenská verze
SD	Slovenská verze/dabing
HU	Maďarská verze
ENG	Anglická verze
ORIG	Originální verze
CZST	České titulky
SKST	Slovenské titulky
ENST	Anglické titulky
HUST	Maďarské titulky
VTST	Vietmanksé titulky