Cineteca di Bologna API: RENZO RENZI LIBRARY DVD/VHS

Cineteca di Bologna API:
RENZO RENZI LIBRARY
DVD/VHS ARCHIVE
Revision: 1
Release date: Oct 31st, 2014
License: Creative Commons No Rights Reserved (CC0)
Abstract
Cineteca di Bologna’s website offers the possibility to
query the database of their DVDs and VHSs available
for viewing and/or loaning.
COMUNE DI BOLOGNA
Dipartimento Economia e Promozione della Città - Settore Agenda Digitale e Tecnologie Informatiche
40129 Bologna – piazza Liber Paradisus, 10, Torre B - e-mail [email protected]
API request method
Request URL:
http://www.cinetecadibologna.it/api/GetFilm?
director=[string]&title=[string]&available=[availabilitycode]
The API can be invoked without or with any of the following parameters:
•
•
•
director: a string to be searched in directors list, ie. If you are looking for
Michelangelo Antonioni you can use "antonioni” as search string (search is case
insensitive);
title: a string to be searched in titles list (please note: for non-Italian movies both
original and Italian titles are searched);
available: this parameter supports the following values:
o 0 (or not set): any availability;
o 1: currently available for loan;
o 2: generally available for loan, but currently loaned;
o 3: generally not available for loan, but available for viewing in Renzo Renzi
library.
If more than one parameter is set, the API will respond with movies that match all of the
set parameters.
Notes on movies availability
Please note that availability is updated on a daily basis, not in real time. API response is
based on morning availability, bear in mind that if a movie is marked as available it may
also have been loaned during the day.
COMUNE DI BOLOGNA
Dipartimento Economia e Promozione della Città - Settore Agenda Digitale e Tecnologie Informatiche
40129 Bologna – piazza Liber Paradisus, 10, Torre B - e-mail [email protected]
API response
The response is an XML file with the following structure:
<?xml version="1.0" encoding="iso-8859-1" ?>
<Films>
<Film>
<Title>[Title]</Title>
<Director>[Director]</Director>
<Year>[Year]</Year>
<Format>[Format]</Format>
<Location>[Location]</Location>
<Audio>[AudioLanguages]</Audio>
<Subtitles>[SubLanguages]</Subtitles>
<Availability>[AvailabilityCode]</Availability>
<URL>[Url]</URL>
</Film>
<Film>…</Film>
</Films>
Where:
•
•
•
•
•
•
•
•
•
[Title]: original title and Italian title in brackets, ie. “1492: the conquest of paradise
(1492: la conquista del paradise)”;
[Director]: director surname and name, ie. “Scott, Ridley”;
[Year]: production year;
[Format]: support format, ie. “VHS” or “DVD”, if more then one format is available,
the item <Film> is duplicated with specific support format (ie. available subtitles may
vary depending on support format);
[Location]: location code in library’s archive;
[AudioLanguages]: language code in 3 letters (ie. “ITA”), if more than one language
is available in the same support, they are separated by spaces (ie. “ITA ENG”);
[SubLanguages]: same as audio, if no subtitles are available the tag is empty;
[AvailabilityCode]: see description in API request method chapter;
[Url]: the URL of the movie page on Cineteca di Bologna’s website.
COMUNE DI BOLOGNA
Dipartimento Economia e Promozione della Città - Settore Agenda Digitale e Tecnologie Informatiche
40129 Bologna – piazza Liber Paradisus, 10, Torre B - e-mail [email protected]