Ceci est une ancienne révision du document !


API AlloCiné v3

Suite à une mise à jour de l'API, le paramètre format ne semble plus fonctionnel.

Désormais, le flux est obligatoirement renvoyé au format JSON.

Informations

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 APIs

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.

Recherche : 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
      • tvseries : afficher les séries TV
    • 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)

Informations sur un film : 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
      • flv : FLV / H.264
      • mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen
      • mp4-hip : H264 High Profile, with splashscreen
      • mp4-archive : MP4 / H.264 High Profile, for archive
      • mpeg2-theater : MPEG-2 720p
      • mpeg2 : MPEG-2 Main Profile
      • et sûrement d'autres mais je n'ai pas le code correspondant …
    • 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
      • tvseries : afficher les séries TV
    • striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre

Critiques sur un film (presse et public) : reviewlist

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é.

Horaires des cinémas : showtimelist

Informations sur une vidéo : media

* Paramètres

  • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
  • code : identifiant de la vidéo (entier)
  • profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large)
  • mediafmt (optionnel) : format vidéo
    • flv : FLV / H.264
    • mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen
    • mp4-hip : H264 High Profile, with splashscreen
    • mp4-archive : MP4 / H.264 High Profile, for archive
    • mpeg2-theater : MPEG-2 720p
    • mpeg2 : MPEG-2 Main Profile
    • et sûrement d'autres mais je n'ai pas le code correspondant …
  • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
  • Exemples :

Informations sur une personne : person

* Paramètres

  • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
  • code : identifiant de la personne (entier)
  • profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large)
  • mediafmt (optionnel) : format vidéo
    • flv : FLV / H.264
    • mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen
    • mp4-hip : H264 High Profile, with splashscreen
    • mp4-archive : MP4 / H.264 High Profile, for archive
    • mpeg2-theater : MPEG-2 720p
    • mpeg2 : MPEG-2 Main Profile
    • et sûrement d'autres mais je n'ai pas le code correspondant …
  • 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
    • tvseries : afficher les séries TV
  • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
  • Exemples :

Filmographie d'une personne : filmography

* Paramètres

  • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
  • code : identifiant de la personne (entier)
  • profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large)
  • 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
    • tvseries : afficher les séries TV
  • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
  • Exemples :

Liste des films en salle : movielist

* Paramètres

  • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
  • code : identifiant de la personne (entier)
  • count (optionnel) : nombre de films à renvoyer (entier)
  • page (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut)

Liste des cinémas : theaterlist

Informations sur une série TV : tvseries

  • Paramètres
    • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
    • code : identifiant de la série (entier)
    • profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large)
    • mediafmt (optionnel) : format vidéo
      • flv : FLV / H.264
      • mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen
      • mp4-hip : H264 High Profile, with splashscreen
      • mp4-archive : MP4 / H.264 High Profile, for archive
      • mpeg2-theater : MPEG-2 720p
      • mpeg2 : MPEG-2 Main Profile
      • et sûrement d'autres mais je n'ai pas le code correspondant …
    • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
    • striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre

Informations sur la saison d'une série TV : season

  • Paramètres
    • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
    • code : identifiant de la saison (entier)
    • profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large)
    • mediafmt (optionnel) : format vidéo
      • flv : FLV / H.264
      • mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen
      • mp4-hip : H264 High Profile, with splashscreen
      • mp4-archive : MP4 / H.264 High Profile, for archive
      • mpeg2-theater : MPEG-2 720p
      • mpeg2 : MPEG-2 Main Profile
      • et sûrement d'autres mais je n'ai pas le code correspondant …
    • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
    • striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre

Informations sur l'épisode d'une série TV : episode

  • Paramètres
    • partner : code partenaire (YW5kcm9pZC12M3M pour l'application Android)
    • code : identifiant de la saison (entier)
    • profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large)
    • mediafmt (optionnel) : format vidéo
      • flv : FLV / H.264
      • mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen
      • mp4-hip : H264 High Profile, with splashscreen
      • mp4-archive : MP4 / H.264 High Profile, for archive
      • mpeg2-theater : MPEG-2 720p
      • mpeg2 : MPEG-2 Main Profile
      • et sûrement d'autres mais je n'ai pas le code correspondant …
    • format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml)
    • striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre

Ils se servent de l'API

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.

Remarques

Il y a peut-être (sûrement) des oublis, donc si vous trouvez quelque chose qui ne va pas ou alors un nouveau service, contactez moi via le formulaire de contact ou bien directement sur mon mail jerome.groven@gmail.com

Remerciements

Merci à tout ceux qui m'ont contacté pour me signaler des nouveaux services, comme Olivier B. pour m'avoir mis sur la piste pour les séries ;-)

gentoo powered apache powered dokuwiki powered