Export katalogu filmů (MOVIES.XML)

Změněno 2019/09/19 08:35 od Jaroslav Juřica — Kategorizován jako: Nekategorizované

Generuje aktuální katalog filmů definovaný v UFD. Lze použít pro doplnění katalogu filmů v pokladním systému, popř pro doplnění kódů filmů pro export výsledků. Formát datové věty je XML, soubor je validován. Výstup je veřejný, pro generování není nutno odesílat žádné přihlašovací údaje.

Volání exportu katalogu filmů
https://api.disfilm.cz/movies
https://api.disfilm.cz/movies?by=title
https://api.disfilm.cz/movies?key=klic&by=format

Validační schéma MOVIES.XSD
http://www.disfilm.cz/xsd/movies.xsd
Ve schématu naleznete podrobnější popis datové věty.

Vzorový soubor
https://www.disfilm.cz/xsd/movies.xml
Zde najdete vzorový výstup z katalogu.

Export katalogu je možné volat s následujícími parametry:

key=HGqekfjf... - parametr pro volání exportu filmů nasazených ve vybraném kině (dostupné pouze v režimu DisFilm+)

by=title - film je v exportu obsažen pouze jednou a seznam dostupných formátů/úprav se generuje do elementu formatLanguages

by=format - pokud je nastaven tento parametr, filmy se rozdělí podle formátu a jazykové úpravy. Do titulu filmu se přidá formát a v závorce zkratka jazykové úpravy. Do čísla filmu se na poslední dvě místa přidají kód formátu a úpravy podle následující tabulky:

Název formátu	Export kód (export v elementu formatLanguages)	Zkratka (přidán k titulu filmu při nastavení parametru by=format)	Kód (přidán do čísla filmu při nastavení parametru by=format)
35mm	Analog	35	E
70mm	Analog	70	E
DVD	DVD	DVD	F
DCP 2D	DCI2D	2D	A
DCP 3D	DCI3D	3D	B
Blu-ray	BLURAY	BR	G
IMAX	IMAX	IMX	H
HFR 2D	HFR2D	HF2	K
HFR 3D	HFR3D	HF3	M
PC projekce	PC	MP4	L
IMAX 2D	IMAX2D	IMAX 2D	C
IMAX 3D	IMAX3D	IMAX 3D	D
Živý přenos	LIVE	LIV	P
4DX 2D	4DX2D	4D2	Q
4DX 3D	4DX3D	4D3	R
Superscreen 2D	SSC2D	2DS	S
Superscreen 3D	SSC3D	3DS	T
DCP 2D ATMOS	DCI2DA	2DA	U
DCP 3D ATMOS	DCI3DA	3DA	V
D-BOX 2D	DBX2D	DB2	W
D-BOX 3D	DBX3D	DB3	X
D-BOX 2D ATMOS	DBX2DA	DB2A	Y

Jazyková úprava	Export kód (export v elementu formatLanguages)	Zkratka (přidán k titulu filmu při nastavení parametru by=format)	Kód (přidán do čísla filmu při nastavení parametru by=format)
České titulky	CZST	ČT	1
Anglické titulky	ENST	AT	6
Česká verze	CZ	ČV	5
Slovenská verze	SK	SV	4
Originál verze	ORIG	OV	3
Anglická verze	ENG	AV	3
Vietnamské titulky	VTST	VT	9

Element MOVIE - položka jednoho filmu (umístěno v elementu DATA)
Element MOVIE definuje jednotlivé filmy v katalogu

Položka	Popis položky
code	Kód filmu dle specifikace UFD (max 10zn)
title	Titul filmu
titleOrig	Originální titul filmu
distribCode	kód distributora dle UFD (max 3 znaky)
distribName	název distributora
releaseDate	datum premiéry
genre	žánr filmu
rating	přístupnost filmu (0 - přístupný, 10, 12, 15, 18)
length	délka filmu v minutách
origVersion	původní znění
rights	poskytovatel práv
accountingCode	účetní číslo
format	formát filmu (export kód viz čísleník)
language	jazyková úprava (export kód viz čísleník)
country	země původu (produkce)
cast	hrají
slogan	slogan
synopsis	synopse / obsah
formatLanguages	seznam dostupných formátů/úprav (pouze v režimu by=title)