Api de remontée de programmation

L'Api de remontée de programmation vous permet de récupérer la programmation de tous vos cinémas.
Toutes les requêtes de consultation sont faites avec la méthode GET. Lorsqu’une requête de lecture réussit, vous obtenez une réponse au format JSON accompagné du code HTTP “200 OK”. Ce type d’url peut être consulté depuis un navigateur.
La programmation est mise à jour toutes les 10 minutes à heure fixe (9h00, 9h10, 9h20...), il est donc inutile de faire des requêtes plus fréquemment.
Pour une mise à jour optimale nous conseillons d'effectuer vos requêtes à heures fixes multiples de 10 minutes + 1 (9h01, 9h11, 9h21...)

Authentification

Chaque requête doit être authentifiée via le protocole HTTP Basic Authentication. Pour effectuer des tests vous pouvez utiliser l’utilisateur «test» avec le mot de passe «test».
exemple: https://test:test@movies.monnaie-services.com/FR/prog/v0/?version=0

Récupération de la programmation

La récupération de la programmation se fait à l’aide de l’url:
https://movies.monnaie-services.com/<pays>/prog/v0/?version=<version>

Paramètres

pays

Le code du pays. Les pays actuellement disponibles sont 'FR' (france), 'ES' (espagne), 'CH' (suisse), 'BE' (belgique) et 'MA' (maroc)

version

Toute programmation est versionnée à l’aide d’un numéro de version ce qui vous permet de télécharger uniquement la programmation des cinémas qui ont changés depuis la dernière mise à jour.
Le paramètre version doit contenir la version de programmation que vous avez obtenue lors de votre dernière mise à jour.
Si vous n’avez jamais effectué de mise à jour il vous suffit de passer ‘0’ dans ce paramètre et vous obtiendrez la totalité de votre programmation.
Pour information cette valeur est une date au format timestamp unix. Seuls les cinémas dont la programmation a été modifiée après cette date sont renvoyés dans l'API.

Réponse

L’object JSON renvoyé par cette API a la structure suivante :

version (integer)

Ce champ contient la version de la programmation courante. C’est sa valeur qu’il faudra utiliser dans votre prochain appel à l’API.
Pour information cette valeur est une date au format timestamp unix. Elle contient la dernière date de modification des cinémas interrogés.

sites (tableau)

Ce champ contient la liste de tous les cinémas (sites) qui ont été modifiés depuis la dernière mise à jour.
La liste des proriétés décrites ci-dessous n'est pas exausitive, elle dépend de votre contrat. Merci de contacter Monnaie-Services si vous désirez plus de propriété.

sites.id (string)

Identifiant du cinéma.

sites.name (string)

Nom du cinéma.

sites.city (string)

Ville du cinéma.

sites.events (tableau)

Contient la liste de tous les films programmés dans le cinéma.
La liste des proriétés décrites ci-dessous n'est pas exausitive, elle dépend de votre contrat. Merci de contacter Monnaie-Services si vous désirez plus d'information concernant les films.

sites.events.id (string)

Identifiant du film.

sites.events.title (string)

Titre du film.

sites.events.director (string)

Réalisateur.

sites.events.actors (string)

Acteurs.

sites.events.release_date (string)

Date de sortie.

sites.events.country (string)

Code ISO du pays du film.

sites.events.genres (string)

Genres.

sites.events.localized_genres (string)

Genres localisés.

sites.events.synopsis (string)

Synopsis.

sites.events.bill_url (url)

Url de l’affiche du film en 120 pixels de large
Il faut remplacer /120/ par :

sites.events.backdrop_urls (tableau d'urls)

Urls des photos du film en 120 pixels de large
Il faut remplacer /120/ par :

sites.events.trailer_url (url)

Url du trailer du film en basse résolution (pour téléphones mobiles)
Il faut remplacer /ld/ par :

Les bandes annonces sont hébergées par le service vidéo-cloud de Monnaie-Services qui prend le coût de toute la bande passante à sa charge. De ce fait l'accès aux bandes annonces est un service payant que vous devez activer en contactant le service commercial de Monnaie-Services.

sites.events.thumbnail_url (url)

Url de l’image du trailer du film en 120 pixels de large
Il faut remplacer /120/ par :

sites.events.duration (entier)

Durée du film en minutes.

sites.events.certification_id (string)

Classification: ALL,A, A<age> ou R<age>

sites.events.sessions (tableau)

Contient la liste de toutes les séances programmées pour ce film.

sites.events.sessions.id (string)

Identifiant de la séance.

sites.events.sessions.date (string)

Date de la séance (format:201805311830 heure locale du cinéma).

sites.events.sessions.hall_id (string)

Identifiant de Salle.

sites.events.sessions.hall_name (string)

Nom de Salle.

sites.events.sessions.booking_url (url)

Url de réservation pour les séances accessibles en VAD. Vous pouvez enrichir cet URL avec les paramètres suivants:

sites.events.sessions.super_billets (tableau de string)

Si la séance est associée à un ou plusieurs super billets, cette valeur contient les identifiants des super billets.

sites.events.sessions.version (obsolète)

Proriété obsolète, utiliser vo de sites.events.sessions.features
VO ou VF

sites.events.sessions.formats (obsolète)

Proriété obsolète, utiliser plutôt sites.events.sessions.features
Liste des formats sonores et video séparés par des virgules.
Les formats supportés sont:
3D,4K,HFR,ST,OCAP,CCAP,7.1,ATMOS,AURO3D,DTS-X,HI,VI,LAZER

sites.events.sessions.audio_lang (string)

Code 2 lettres (fr) ou 5 lettres (fr_FR) de la langue. Peut valoir muted pour les films muets.

sites.events.sessions.subtitle_lang (string)

Code 2 lettres (fr) ou 5 lettres (fr_FR) de la langue des soustitres.

sites.events.sessions.special_type (string | undefined)

Prend la valeur school pour les séances scolaires et private pour les séances privées. N'est pas définit pour les séances normales.

sites.events.sessions.features (array)

Listes des particularités de la séance. Les valeurs possibles sont: