INTERFACAGE AVEC MOVIECOVERS

Version 1.1, 5 septembre 2003

Les programmes peuvent rappatrier des informations depuis le site MOVIECOVERS par le même biais que les navigateurs, en effectuant des requêtes HTTP.

Ressources disponibles

Toutes les pages et ressources accessibles aux utilisateurs sont bien entendu aussi disponibles pour les programmes, notamment les pages de listes, les recherches multicritères, les fiches de films, le générateur d'archives ZIP...

Il existe quelques ressources supplémentaires à destination des programmes :

• https://moviecovers.com/DATA/movies.txt est un fichier texte, mis à jour toutes les 24 heures, contenant la date de la mise à jour, suivie par la liste des identifiants (IDMC) de tous les films de la base.
• https://moviecovers.com/DATA/movies.zip contient la même chose sous forme compressée
• https://moviecovers.com/getfilm.html est un script qui renvoit la fiche d'un film au format .FILM. Il accepte les requêtes de type HTTP POST uniquement, et attend l'IDMC du film demandé dans le champ "idmc".

Une interface plus simple et plus stable, à base de XML, sera peut-être ajoutée ultérieurement (des volontaires ?)

Formats employés

Les IDMC sont des chaînes de caractères quelconques qui identifient de manière unique un film dans la base. Les IDMC sont souvent identiques au titre français du film, mais il y a parfois des petites différences, il convient de les distinguer.

Dans movies.txt, certains caractères des IDMC peuvent être "URI encodés" (remplacés par "%" + deux caractères hexadécimaux du code ASCII du caractère remplacé). Un certain nombre de mots sont également "rejetés" à la fin et mis entre parenthèses pour améliorer l'ordre de tri : LES, LE, LA, L, UNE, UN, THE, AN, EL, C7A, CCM, CDM, CIM, VRM, suivis d'un espace ou d'une apostrophe. (ce n'est pas ce qui a été fait de mieux, mais il est un peu tard pour changer...)

Les fichiers .FILM contenant les informations sur un film sont des fichiers textes (jeu de caractères ISO-8859-1, retours de ligne CR+LF), contenant un champ par ligne, dans l'ordre :

• Titre français en majuscules
• Nom du(des) réalisateur(s), séparés par des "/"
• L'année de sortie en France, sur 4 chiffres
• La(les) nationalités du film, séparés par des "/". La liste des nationalités évolue au fur et à mesure des ajouts de films.
• Le(les) genre(s) du film, séparés par des ",". La liste des genres évolue au fur et à mesure des ajouts de films.
• La durée du film, au format hhHmm.
• Une liste de noms d'acteurs et d'actrices, séparés par des ";"
• Un court résumé du film
• Le nom du distributeur en France, en majuscules
• Le titre original en majuscules, pour les films étrangers
• Des mots clés supplémentaires pour indexer le film, en majuscules, séparés par des " " (espaces) ou des ";".

Tous les noms de personnes sont écrits sans accents, avec une capitale au prénom, suivi du nom en majuscules.

Des lignes supplémentaires seront peut-être ajoutées ultérieurement. Un format plus souple, à base d'XML également, est envisagé (des volontaires ?)

Historique

• 18 avril 2002 : Version 1.0
  Première version des spécifications.
• 5 septembre 2003 : Version 1.1
  Correction d'un bug dans la description du format des fichiers .FILM (oubli de la ligne pour le titre original du film)
  Ajout de précisions sur le formatage des autres informations des .FILM.

Pour toute remarque ou information complémentaire, n'hésitez pas à m'écrire.

Pierre Etchemaïté.