Ceci est une ancienne révision du document !
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.
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 recherchetheater
: afficher les cinémasperson
: afficher les acteurs, réalisateurs, etc. (personnes)news
: afficher les newstvseries
: afficher les séries TVcount
(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)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 recherchetheater
: afficher les cinémasperson
: afficher les acteurs, réalisateurs, etc. (personnes)news
: afficher les newsstriptags
(optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètrepartner
: 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
)
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é.
zip
: code postal de la villelat
: 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-DDInfos 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.
Contactez moi via le formulaire de contact ou bien directement sur mon mail jerome.groven@gmail.com