API AlloCiné v3

AlloCiné a mis à jour il y a quelques temps ses APIs.
Je vais tenter de les expliquer sur cette nouvelle page.

Pour les découvrir, j'ai utilisé le même principe que la première fois. Une petite différence est à noter, il semblerait que la valeur partner a changé depuis. Sa valeur sera désormais YW5kcm9pZC12M3M.

L'URL de base a, elle aussi, changé : ''http://api.allocine.fr/rest/v3/''

Les différentes APIs s'appellent toutes en GET. Je n'ai pas testé en POST mais si c'est comme avant, ça ne devrait pas marcher.

• URL : http://api.allocine.fr/rest/v3/search
• Paramètres
  • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
  • q : chaîne à chercher (chaîne de caractères)
  • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
  • filter (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules)
    • movie : afficher les films correspondant à la recherche
    • theater : afficher les cinémas
    • person : afficher les acteurs, réalisateurs, etc. (personnes)
    • news : afficher les news
  • count (optionnel) : nombre de résultats à renvoyer (entier)
  • page (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut)
• Exemple : http://api.allocine.fr/rest/v3/search?partner=YW5kcm9pZC12M3M&filter=movie,theater,person,news&count=5&page=1&q=avatar&format=json

• URL : http://api.allocine.fr/rest/v3/movie
• Paramètres
  • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
  • code : identifiant du film (entier)
  • profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large)
  • mediafmt (optionnel) : format vidéo (valeurs possibles : mp4, mp4-lc, ???)
  • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
  • filter (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules)
    • movie : afficher les films correspondant à la recherche
    • theater : afficher les cinémas
    • person : afficher les acteurs, réalisateurs, etc. (personnes)
    • news : afficher les news
  • striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre
• Exemple : http://api.allocine.fr/rest/v3/movie?partner=YW5kcm9pZC12M3M&code=61282&profile=large&mediafmt=mp4-lc&format=json&filter=movie&striptags=synopsis,synopsisshort

• à compléter

• zip : code postal de la ville
• lat : coordonnée latitude du cinéma (uniquement si zip n'est pas précisé)
• long : coordonnée longitude du cinéma (uniquement si zip n'est pas précisé)
• radius : rayon autour de la ville en question (entre 1 et 500 km)
• partner : schéma XML à utiliser en fonction des partenaires (1, 2, 3, 4)
• json (optionnel) : renvoie le résultat au format JSON si json=1 (booléen)
• movie (optionnel) : identifiant du film (si non préciser, affiche tous les films)
• date (optionnel) : date au format YYYY-MM-DD

En bonus, voici une autre API qui permet de récupérer les liens directs vers les vidéos (émission, bande-annonce, etc.). Il est possible de récupérer la vidéo en LD/MD/HD.

• URL : http://www.allocine.fr/skin/video/AcVisionData_xml.asp
• Paramètres
  • media : identifiant du média vidéo (entier)

Cet identifiant peut être récupéré grâce à l'API movie par exemple. Il correspond à l'attribut code des <media class=“video”>.

Si jamais vous tombez sur cette page et que vous vous servez de cette API, je me ferais une joie de lister votre application ici.

• EzTvix : http://blog.eztvix.info
• Str9am : http://www.abysscorp.org/project/str9am
• Ma filmothèque : http://ma-filmotheque.fr
• WebMovieManager : http://sourceforge.net/projects/webmoviemanager/
• AlloWMC : https://sites.google.com/site/allowmc/home

Contactez moi via le formulaire de contact ou bien directement sur mon mail jerome.groven@gmail.com