API AlloCiné v3

Un nouveau système de signature des appels a été mis en place.

Un exemple d'utilisation en PHP est dispo sur mon GitHub : https://github.com/gromez/allocine-api.

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

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

Informations sur un film : movie

  • Paramètres
    • partner : code partenaire (QUNXZWItQWxsb0Npbuk 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=QUNXZWItQWxsb0Npbuk&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 (QUNXZWItQWxsb0Npbuk 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 (QUNXZWItQWxsb0Npbuk 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 (QUNXZWItQWxsb0Npbuk 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 (QUNXZWItQWxsb0Npbuk 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 (QUNXZWItQWxsb0Npbuk 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 (QUNXZWItQWxsb0Npbuk 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 (QUNXZWItQWxsb0Npbuk 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

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