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

• URL : http://api.allocine.fr/rest/v3/reviewlist
• Paramètres
  • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
  • type : type (valeurs possibles : movie, ???)
  • code : identifiant du film (entier)
  • filter : type de critique, presse (desk-press) ou public (public)
  • count (optionnel) : nombre de critiques à renvoyer (entier)
  • page (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut)
  • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
• Exemples :
  • http://api.allocine.fr/rest/v3/reviewlist?partner=YW5kcm9pZC12M3M&type=movie&code=61282&filter=public&count=30&format=json
  • http://api.allocine.fr/rest/v3/reviewlist?partner=YW5kcm9pZC12M3M&type=movie&filter=desk-press&code=61282&count=30&format=json

A noter qu'une autre façon de construire la requête existe. Il faut pour cela utiliser le paramètre subject : http://api.allocine.fr/rest/v3/reviewlist?partner=YW5kcm9pZC12M3M&filter=public&subject=movie:61282&format=json
Le reste des paramètres reste inchangé.

• URL : http://api.allocine.fr/rest/v3/showtimelist
• Paramètres
  • 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
• Exemples :
  • http://api.allocine.fr/rest/v3/showtimelist?partner=YW5kcm9pZC12M3M&movie=61282&format=json&radius=50&lat=49.0176394&date=2011-08-21&long=-0.3498428
  • http://api.allocine.fr/rest/v3/showtimelist?partner=YW5kcm9pZC12M3M&movie=61282&format=json&location=ugc%20mondeville&date=2011-08-21

Infos sur une vidéo : /rest/v3/media?partner=YW5kcm9pZC12M3M&code=19135625&profile=large&mediafmt=mp4-lc&format=json

Infos sur une personne : /rest/v3/person?partner=YW5kcm9pZC12M3M&profile=large&code=41339&mediafmt=mp4-lc&filter=movie&format=json

Filmographie d'une personne : /rest/v3/filmography?partner=YW5kcm9pZC12M3M&profile=medium&code=41339&filter=movie&format=json

Liste des nouveautés triée par nombre de salles : /rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=nowshowing&page=1&order=theatercount&format=json

Liste des nouveautés triée par date : /rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=nowshowing&page=1&order=datedesc&format=json

Liste des films à venir triés par les plus attendus : /rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=comingsoon&page=1&order=toprank&format=json

Liste des films à venir triés par date : /rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=comingsoon&page=1&order=dateasc&format=json

Liste des cinémas : /rest/v3/theaterlist?partner=YW5kcm9pZC12M3M&count=25&page=1&lat=49.01716825&long=-0.3499346&format=json

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