| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| dev:api:allocine_v3 [30/03/2012 12:07] – gromez | dev:api:allocine_v3 [12/08/2013 22:33] (Version actuelle) – [Ils se servent de l'API] gromez |
|---|
| ====== API AlloCiné v3 ====== | ====== API AlloCiné v3 ====== |
| |
| | <html> |
| | <div style="padding: 10px 0; width: 700px; font-weight: bold; border: 1px solid #636b70; background-color: #f5f5f5; text-align: center; color: #ff3636;"> |
| | <p style="margin: 0;">Un nouveau système de signature des appels a été mis en place.</p> |
| | <p style="margin: 0;">Un exemple d'utilisation en PHP est dispo sur mon GitHub : <a href="https://github.com/gromez/allocine-api" target="_blank">https://github.com/gromez/allocine-api</a>.</p> |
| | </div> |
| | </html> |
| ===== Informations ===== | ===== Informations ===== |
| |
| Je vais tenter de les expliquer sur cette nouvelle page. | Je vais tenter de les expliquer sur cette nouvelle page. |
| |
| Pour les découvrir, j'ai utilisé le même principe que [[allocine|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''. | Pour les découvrir, j'ai utilisé le même principe que [[allocine|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/%%'' | L'URL de base a, elle aussi, changé : ''%%http://api.allocine.fr/rest/v3/%%'' |
| * URL : ''http://api.allocine.fr/rest/v3/search'' | * URL : ''http://api.allocine.fr/rest/v3/search'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''q'' : chaîne à chercher (chaîne de caractères) | * ''q'' : chaîne à chercher (chaîne de caractères) |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') |
| * ''tvseries'' : afficher les séries TV | * ''tvseries'' : afficher les séries TV |
| * ''count'' (optionnel) : nombre de résultats à renvoyer (entier) | * ''count'' (optionnel) : nombre de résultats à renvoyer (entier) |
| * Exemple : ''http://api.allocine.fr/rest/v3/search?partner=YW5kcm9pZC12M3M&filter=movie,theater,person,news,tvseries&count=5&page=1&q=avatar&format=json'' | * Exemple : ''http://api.allocine.fr/rest/v3/search?partner=QUNXZWItQWxsb0Npbuk&filter=movie,theater,person,news,tvseries&count=5&page=1&q=avatar&format=json'' |
| * ''page'' (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) | * ''page'' (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) |
| |
| * URL : ''http://api.allocine.fr/rest/v3/movie'' | * URL : ''http://api.allocine.fr/rest/v3/movie'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant du film (entier) | * ''code'' : identifiant du film (entier) |
| * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| * ''tvseries'' : afficher les séries TV | * ''tvseries'' : afficher les séries TV |
| * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre | * ''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'' | * Exemple : ''http://api.allocine.fr/rest/v3/movie?partner=QUNXZWItQWxsb0Npbuk&code=61282&profile=large&mediafmt=mp4-lc&format=json&filter=movie&striptags=synopsis,synopsisshort'' |
| |
| ==== Critiques sur un film (presse et public) : reviewlist ==== | ==== Critiques sur un film (presse et public) : reviewlist ==== |
| * URL : ''http://api.allocine.fr/rest/v3/reviewlist'' | * URL : ''http://api.allocine.fr/rest/v3/reviewlist'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''type'' : type (valeurs possibles : ''movie'', ???) | * ''type'' : type (valeurs possibles : ''movie'', ???) |
| * ''code'' : identifiant du film (entier) | * ''code'' : identifiant du film (entier) |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') |
| * Exemples : | * 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=QUNXZWItQWxsb0Npbuk&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'' | * ''http://api.allocine.fr/rest/v3/reviewlist?partner=QUNXZWItQWxsb0Npbuk&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''\\ | 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é. | Le reste des paramètres reste inchangé. |
| | |
| * URL : ''http://api.allocine.fr/rest/v3/showtimelist'' | * URL : ''http://api.allocine.fr/rest/v3/showtimelist'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''zip'' : code postal de la ville | * ''zip'' : code postal de la ville |
| * ''lat'' : coordonnée latitude du cinéma | * ''lat'' : coordonnée latitude du cinéma |
| * ''date'' (optionnel) : date au format YYYY-MM-DD (si non précisé, date du jour) | * ''date'' (optionnel) : date au format YYYY-MM-DD (si non précisé, date du jour) |
| * Exemples : | * Exemples : |
| * ''http://api.allocine.fr/rest/v3/showtimelist?partner=YW5kcm9pZC12M3M&format=json&radius=50&lat=49.0176394&long=-0.3498428'' | * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&format=json&radius=50&lat=49.0176394&long=-0.3498428'' |
| * ''http://api.allocine.fr/rest/v3/showtimelist?partner=YW5kcm9pZC12M3M&q=61282&format=xml&theaters=P0728'' | * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=xml&theaters=P0728'' |
| * ''http://api.allocine.fr/rest/v3/showtimelist?partner=YW5kcm9pZC12M3M&q=61282&format=json&location=ugc%20mondeville'' | * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=json&location=ugc%20mondeville'' |
| * ''http://api.allocine.fr/rest/v3/showtimelist?partner=YW5kcm9pZC12M3M&q=61282&format=json&zip=14000'' | * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=json&zip=14000'' |
| |
| ==== Informations sur une vidéo : media ==== | ==== Informations sur une vidéo : media ==== |
| * URL : ''http://api.allocine.fr/rest/v3/media'' | * URL : ''http://api.allocine.fr/rest/v3/media'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant de la vidéo (entier) | * ''code'' : identifiant de la vidéo (entier) |
| * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') |
| * Exemples : | * Exemples : |
| * ''http://api.allocine.fr/rest/v3/media?partner=YW5kcm9pZC12M3M&code=19135625&profile=large&mediafmt=mp4-lc&format=json'' | * ''http://api.allocine.fr/rest/v3/media?partner=QUNXZWItQWxsb0Npbuk&code=19135625&profile=large&mediafmt=mp4-lc&format=json'' |
| |
| ==== Informations sur une personne : person ==== | ==== Informations sur une personne : person ==== |
| * URL : ''http://api.allocine.fr/rest/v3/person'' | * URL : ''http://api.allocine.fr/rest/v3/person'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant de la personne (entier) | * ''code'' : identifiant de la personne (entier) |
| * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') |
| * Exemples : | * Exemples : |
| * ''http://api.allocine.fr/rest/v3/person?partner=YW5kcm9pZC12M3M&profile=large&code=41339&mediafmt=mp4-lc&filter=movie&format=json'' | * ''http://api.allocine.fr/rest/v3/person?partner=QUNXZWItQWxsb0Npbuk&profile=large&code=41339&mediafmt=mp4-lc&filter=movie&format=json'' |
| |
| ==== Filmographie d'une personne : filmography ==== | ==== Filmographie d'une personne : filmography ==== |
| * URL : ''http://api.allocine.fr/rest/v3/filmography'' | * URL : ''http://api.allocine.fr/rest/v3/filmography'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant de la personne (entier) | * ''code'' : identifiant de la personne (entier) |
| * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') |
| * Exemples : | * Exemples : |
| * ''http://api.allocine.fr/rest/v3/filmography?partner=YW5kcm9pZC12M3M&profile=medium&code=41339&filter=movie&format=json'' | * ''http://api.allocine.fr/rest/v3/filmography?partner=QUNXZWItQWxsb0Npbuk&profile=medium&code=41339&filter=movie&format=json'' |
| |
| ==== Liste des films en salle : movielist ==== | ==== Liste des films en salle : movielist ==== |
| * URL : ''http://api.allocine.fr/rest/v3/movielist'' | * URL : ''http://api.allocine.fr/rest/v3/movielist'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant de la personne (entier) | * ''code'' : identifiant de la personne (entier) |
| * ''count'' (optionnel) : nombre de films à renvoyer (entier) | * ''count'' (optionnel) : nombre de films à renvoyer (entier) |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') |
| * Exemples : | * Exemples : |
| * Films en salle triées par nombre de salles : ''http://api.allocine.fr/rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=nowshowing&page=1&order=theatercount&format=json'' | * Films en salle triées par nombre de salles : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=nowshowing&page=1&order=theatercount&format=json'' |
| * Films en salle triées par date de sortie : ''http://api.allocine.fr/rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=nowshowing&page=1&order=datedesc&format=json'' | * Films en salle triées par date de sortie : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=nowshowing&page=1&order=datedesc&format=json'' |
| * Films à paraitre les plus attendus : ''http://api.allocine.fr/rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=comingsoon&page=1&order=toprank&format=json'' | * Films à paraitre les plus attendus : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=comingsoon&page=1&order=toprank&format=json'' |
| * Films à paraitre triés par date : ''http://api.allocine.fr/rest/v3/movielist?partner=YW5kcm9pZC12M3M&count=25&filter=comingsoon&page=1&order=dateasc&format=json'' | * Films à paraitre triés par date : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=comingsoon&page=1&order=dateasc&format=json'' |
| |
| ==== Liste des cinémas : theaterlist ==== | ==== Liste des cinémas : theaterlist ==== |
| * URL : ''http://api.allocine.fr/rest/v3/theaterlist'' | * URL : ''http://api.allocine.fr/rest/v3/theaterlist'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''zip'' : code postal de la ville | * ''zip'' : code postal de la ville |
| * ''lat'' : coordonnée latitude du cinéma | * ''lat'' : coordonnée latitude du cinéma |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') |
| * Exemples : | * Exemples : |
| * ''http://api.allocine.fr/rest/v3/theaterlist?partner=YW5kcm9pZC12M3M&count=25&page=1&lat=49.01716825&long=-0.3499346&format=json'' | * ''http://api.allocine.fr/rest/v3/theaterlist?partner=QUNXZWItQWxsb0Npbuk&count=25&page=1&lat=49.01716825&long=-0.3499346&format=json'' |
| * ''http://api.allocine.fr/rest/v3/theaterlist?partner=YW5kcm9pZC12M3M&count=25&page=1&zip=14000&format=json'' | * ''http://api.allocine.fr/rest/v3/theaterlist?partner=QUNXZWItQWxsb0Npbuk&count=25&page=1&zip=14000&format=json'' |
| |
| ==== Informations sur une série TV : tvseries ==== | ==== Informations sur une série TV : tvseries ==== |
| * URL : ''http://api.allocine.fr/rest/v3/tvseries'' | * URL : ''http://api.allocine.fr/rest/v3/tvseries'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant de la série (entier) | * ''code'' : identifiant de la série (entier) |
| * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''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 | * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre |
| * Exemple : ''http://api.allocine.fr/rest/v3/tvseries?partner=YW5kcm9pZC12M3M&code=223&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' | * Exemple : ''http://api.allocine.fr/rest/v3/tvseries?partner=QUNXZWItQWxsb0Npbuk&code=223&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' |
| | |
| ==== Informations sur la saison d'une série TV : season ==== | ==== Informations sur la saison d'une série TV : season ==== |
| * URL : ''http://api.allocine.fr/rest/v3/season'' | * URL : ''http://api.allocine.fr/rest/v3/season'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant de la saison (entier) | * ''code'' : identifiant de la saison (entier) |
| * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''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 | * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre |
| * Exemple : ''http://api.allocine.fr/rest/v3/season?partner=YW5kcm9pZC12M3M&code=12277&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' | * Exemple : ''http://api.allocine.fr/rest/v3/season?partner=QUNXZWItQWxsb0Npbuk&code=12277&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' |
| | |
| ==== Informations sur l'épisode d'une série TV : episode ==== | ==== Informations sur l'épisode d'une série TV : episode ==== |
| * URL : ''http://api.allocine.fr/rest/v3/episode'' | * URL : ''http://api.allocine.fr/rest/v3/episode'' |
| * Paramètres | * Paramètres |
| * ''partner'' : code partenaire (''YW5kcm9pZC12M3M'' pour l'application Android) | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| * ''code'' : identifiant de la saison (entier) | * ''code'' : identifiant de la saison (entier) |
| * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | * ''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 | * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre |
| * Exemple : ''http://api.allocine.fr/rest/v3/episode?partner=YW5kcm9pZC12M3M&code=233016&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' | * Exemple : ''http://api.allocine.fr/rest/v3/episode?partner=QUNXZWItQWxsb0Npbuk&code=233016&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' |
| |
| ===== Ils se servent de l'API ===== | ===== Ils se servent de l'API ===== |
| * Lib DotNet : http://allocineapi.codeplex.com/ | * Lib DotNet : http://allocineapi.codeplex.com/ |
| * Application Android CinéMinute : https://play.google.com/store/apps/details?id=info.toyonos.cineminute | * Application Android CinéMinute : https://play.google.com/store/apps/details?id=info.toyonos.cineminute |
| | * Cinegeek : http://cinegeek.alwaysdata.net/ |
| | * API CoffeeScript : https://github.com/cedias/AlloCoffee |
| | * Application Android CinéTime : https://play.google.com/store/apps/details?id=fr.neamar.cinetime |
| | * MovieFlow Android : http://www.movieflow.net/ |
| | * Module Node.js : https://github.com/leeroybrun/node-allocine-api |
| ===== Remarques ===== | ===== Remarques ===== |
| |