Différences
Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.
|
dev:api:allocine_v3 [17/08/2011 10:05] gromez créée |
dev:api:allocine_v3 [12/08/2013 22:33] (Version actuelle) gromez [Ils se servent de l'API] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | ====== API AlloCiné ====== | + | ====== API AlloCiné v3 ====== |
| - | ===== La démarche ===== | + | <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 ===== | ||
| - | Depuis le temps qu'[[http://www.allocine.fr|AlloCiné]] existe, aucune API n'a encore été faite, ce qui est quand même inadmissible pour ce site de référence. | + | [[http://www.allocine.fr|AlloCiné]] a mis à jour il y a quelques temps ses APIs.\\ |
| + | Je vais tenter de les expliquer sur cette nouvelle page. | ||
| - | Donc jusqu'à lors, quiconque voulait utiliser AlloCiné pour récupérer des données sur tel ou tel film était obligé de faire du parsing sauvage de leur site web. Mais c'était sans compter sur un peu de <del>reverse engineering</del> bonne volonté ! | + | 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''. |
| - | Pour y arriver, je me suis servi de l'[[http://www.cyrket.com/p/android/com.allocine.androidapp/|application AlloCiné disponible sur l'Android Market]]. Je l'ai donc installé sur mon téléphone tout en lançant en parallèle un ''tcpdump'' afin de capturer l'activité réseau. Et oh, miracle, une certaine adresse ''api.allocine.fr'' était appelée. Bingo ! | + | L'URL de base a, elle aussi, changé : ''%%http://api.allocine.fr/rest/v3/%%'' |
| - | J'ai donc un peu navigué dans l'application afin de trouver les différents web services. En voici quelques exemples. | + | ===== Les APIs ===== |
| - | * http://api.allocine.fr/xml/movie?format=h264&version=2&partner=3&json=1&profile=large&code=132663 | + | 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. |
| - | * http://api.allocine.fr/xml/movielist?filter=nowshowing&version=2&partner=3&json=1&order=theatercount&page=1&count=25 | + | |
| - | Le premier web service ''movie'' est très intéressant étant donné qu'il permet de récupérer l'intégralité des informations d'un film pour peu qu'on connaisse son identifiant.\\ | + | ==== Recherche : search ==== |
| - | Le second, ''movielist'', permet quant à lui de récupérer une liste de films en fonction de critères particuliers. | + | |
| - | Un problème subsiste tout de même : __comment faire pour récupérer l'identifiant d'un film à partir de son titre ou bien de mots clés__.\\ | + | * URL : ''http://api.allocine.fr/rest/v3/search'' |
| - | En effet, l'application Android ne gère pas encore la recherche, ce qui est bien dommage d'ailleurs. | + | * Paramètres |
| + | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' 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) | ||
| + | * 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) | ||
| - | La première étape fût de trouver le nom du web service dédié à la recherche. Avec un peu de logique, on le trouve en 2 secondes : ''search''. | + | ==== Informations sur un film : movie ==== |
| - | * http://api.allocine.fr/xml/search? | + | |
| - | La seconde étape, un peu plus compliquée, fût de trouver le paramètre auquel on pouvait passer un critère de recherche. Pour cela, j'ai un peu fait le bourrin en utilisant un dictionnaire anglais d'environ 80000 mots et en les essayant un par un (avec un script bien sûr ...). Quelques heures plus tard, j'obtenais une liste de paramètres : | + | * URL : ''http://api.allocine.fr/rest/v3/movie'' |
| - | * count | + | * Paramètres |
| - | * declare | + | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| - | * page | + | * ''code'' : identifiant du film (entier) |
| - | * partner | + | * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') |
| - | * profile | + | * ''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 | ||
| + | * Exemple : ''http://api.allocine.fr/rest/v3/movie?partner=QUNXZWItQWxsb0Npbuk&code=61282&profile=large&mediafmt=mp4-lc&format=json&filter=movie&striptags=synopsis,synopsisshort'' | ||
| - | Pas mal ! Mais aucun de ces paramètres ne permettait de vraiment faire une recherche à partir d'un mot clé ... :-( | + | ==== Critiques sur un film (presse et public) : reviewlist ==== |
| - | Plan B : tester toutes les lettres de l'alphabet.\\ | + | * URL : ''http://api.allocine.fr/rest/v3/reviewlist'' |
| - | Et là, le miracle ! Je tombe sur la lettre ''q'' (comme //query//, logique ...) et ça marche ! | + | * Paramètres |
| - | * http://api.allocine.fr/xml/search?q=pouet&partner=1 | + | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' 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=QUNXZWItQWxsb0Npbuk&type=movie&code=61282&filter=public&count=30&format=json'' | ||
| + | * ''http://api.allocine.fr/rest/v3/reviewlist?partner=QUNXZWItQWxsb0Npbuk&type=movie&filter=desk-press&code=61282&count=30&format=json'' | ||
| - | On a maintenant toutes les APIs nécessaire pour trouver des informations intéressantes à propos d'un film à partir de son nom. | + | 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 ==== | ||
| - | ===== Les APIs ===== | + | * URL : ''http://api.allocine.fr/rest/v3/showtimelist'' |
| + | * Paramètres | ||
| + | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) | ||
| + | * ''zip'' : code postal de la ville | ||
| + | * ''lat'' : coordonnée latitude du cinéma | ||
| + | * ''long'' : coordonnée longitude du cinéma | ||
| + | * ''radius'' : rayon autour du point désigné (entre 1 et 500 km) | ||
| + | * ''theaters'' : liste de codes de cinémas (séparé par une virgule, exemple: ''P0728,P0093'') | ||
| + | * ''location'' : chaîne représentant le cinéma | ||
| + | * ''movie'' (optionnel) : identifiant du film (si non précisé, affiche tous les films) | ||
| + | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | ||
| + | * ''date'' (optionnel) : date au format YYYY-MM-DD (si non précisé, date du jour) | ||
| + | * Exemples : | ||
| + | * ''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=QUNXZWItQWxsb0Npbuk&q=61282&format=xml&theaters=P0728'' | ||
| + | * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=json&location=ugc%20mondeville'' | ||
| + | * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=json&zip=14000'' | ||
| - | Les différentes APIs s'appellent toutes en ''GET''. Le ''POST'' ne semble pas fonctionner. | + | ==== Informations sur une vidéo : media ==== |
| - | ==== Recherche : search ==== | + | * URL : ''http://api.allocine.fr/rest/v3/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 : | ||
| + | * ''http://api.allocine.fr/rest/v3/media?partner=QUNXZWItQWxsb0Npbuk&code=19135625&profile=large&mediafmt=mp4-lc&format=json'' | ||
| - | * URL : ''http://api.allocine.fr/xml/search'' | + | ==== Informations sur une personne : person ==== |
| - | * Paramètres | + | |
| - | * ''q'' : chaîne à chercher (chaîne de caractères) | + | |
| - | * ''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) | + | |
| - | * ''count'' (optionnel) : nombre de résultats à renvoyer (entier) | + | |
| - | * ''profile'' (optionnel) : degré d'informations renvoyées (énumération : ''small'', ''medium'', ''large'') | + | |
| - | * ''page'' (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) | + | |
| - | * ''declare'' (optionnel) : aucune idée !? | + | |
| - | ==== Informations sur un film : movie ==== | + | * URL : ''http://api.allocine.fr/rest/v3/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 : | ||
| + | * ''http://api.allocine.fr/rest/v3/person?partner=QUNXZWItQWxsb0Npbuk&profile=large&code=41339&mediafmt=mp4-lc&filter=movie&format=json'' | ||
| - | * URL : ''http://api.allocine.fr/xml/movie'' | + | ==== Filmographie d'une personne : filmography ==== |
| - | * Paramètres | + | |
| - | * ''code'' : identifiant du film (entier) | + | |
| - | * ''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) | + | |
| - | * ''profile'' (optionnel) : degré d'informations renvoyées (énumération : ''small'', ''medium'', ''large'') | + | |
| - | * ''format'' (optionnel) : format vidéo !? (''h264'', ???) | + | |
| - | * ''version'' (optionnel) : aucune idée !? | + | |
| - | ==== Liste de films : movielist ==== | + | * URL : ''http://api.allocine.fr/rest/v3/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 : | ||
| + | * ''http://api.allocine.fr/rest/v3/filmography?partner=QUNXZWItQWxsb0Npbuk&profile=medium&code=41339&filter=movie&format=json'' | ||
| - | * //à compléter// | + | ==== Liste des films en salle : movielist ==== |
| - | + | ||
| - | ==== Horaires des cinémas : showtimelist ==== | + | |
| - | * ''zip'' : code postal de la ville | + | * URL : ''http://api.allocine.fr/rest/v3/movielist'' |
| - | * ''lat'' : coordonnée latitude du cinéma (uniquement si ''zip'' n'est pas précisé) | + | * Paramètres |
| - | * ''long'' : coordonnée longitude du cinéma (uniquement si ''zip'' n'est pas précisé) | + | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) |
| - | * ''radius'' : rayon autour de la ville en question (entre 1 et 500 km) | + | * ''code'' : identifiant de la personne (entier) |
| - | * ''partner'' : schéma XML à utiliser en fonction des partenaires (''1'', ''2'', ''3'', ''4'') | + | * ''count'' (optionnel) : nombre de films à renvoyer (entier) |
| - | * ''json'' (optionnel) : renvoie le résultat au format JSON si ''json=1'' (booléen) | + | * ''page'' (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) |
| - | * ''movie'' (optionnel) : identifiant du film (si non préciser, affiche tous les films) | + | |
| - | * ''date'' (optionnel) : date au format YYYY-MM-DD | + | * ''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) | ||
| + | * ''nowshowing'' : afficher les films actuellement à l'affiche | ||
| + | * ''comingsoon'' : afficher les films à paraitre | ||
| + | * ''order'' (optionnel) : ordre de tri des résultats | ||
| + | * ''datedesc'' : classement anti-chronologique | ||
| + | * ''dateasc'' : classement chronologique | ||
| + | * ''theatercount'' : classement par nombre de salles | ||
| + | * ''toprank'' : classement par popularité | ||
| + | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | ||
| + | * Exemples : | ||
| + | * 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=QUNXZWItQWxsb0Npbuk&count=25&filter=nowshowing&page=1&order=datedesc&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=QUNXZWItQWxsb0Npbuk&count=25&filter=comingsoon&page=1&order=dateasc&format=json'' | ||
| - | ==== Bonus : liens direct des vidéos ==== | + | ==== Liste des cinémas : theaterlist ==== |
| - | En bonus, voici une autre API qui permet de récupérer les liens directs vers les vidéos (émission, bande-annonce, etc.). Il est possible de récupérer la vidéo en LD/MD/HD. | + | * URL : ''http://api.allocine.fr/rest/v3/theaterlist'' |
| + | * Paramètres | ||
| + | * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) | ||
| + | * ''zip'' : code postal de la ville | ||
| + | * ''lat'' : coordonnée latitude du cinéma | ||
| + | * ''long'' : coordonnée longitude du cinéma | ||
| + | * ''radius'' : rayon autour du point désigné (entre 1 et 500 km) | ||
| + | * ''theater'' : code du cinéma (exemple: ''P0728'') | ||
| + | * ''location'' : chaîne représentant le cinéma | ||
| + | * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') | ||
| + | * Exemples : | ||
| + | * ''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=QUNXZWItQWxsb0Npbuk&count=25&page=1&zip=14000&format=json'' | ||
| - | * URL : ''http://www.allocine.fr/skin/video/AcVisionData_xml.asp'' | + | ==== Informations sur une série TV : tvseries ==== |
| + | |||
| + | * URL : ''http://api.allocine.fr/rest/v3/tvseries'' | ||
| * Paramètres | * Paramètres | ||
| - | * ''media'' : identifiant du média vidéo (entier) | + | * ''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 | ||
| + | * 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 ==== | ||
| - | Cet identifiant peut être récupéré grâce à l'API ''movie'' par exemple. Il correspond à l'attribut ''code'' des ''<media class="video">''. | + | * URL : ''http://api.allocine.fr/rest/v3/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 | ||
| + | * 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 ==== | ||
| + | |||
| + | * URL : ''http://api.allocine.fr/rest/v3/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 | ||
| + | * 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 ===== | ||
| Ligne 99: | Ligne 268: | ||
| * WebMovieManager : http://sourceforge.net/projects/webmoviemanager/ | * WebMovieManager : http://sourceforge.net/projects/webmoviemanager/ | ||
| * AlloWMC : https://sites.google.com/site/allowmc/home | * AlloWMC : https://sites.google.com/site/allowmc/home | ||
| + | * Lib Ruby : https://rubygems.org/gems/allocine_parser & https://github.com/mlamarque/allocine | ||
| + | * Lib DotNet : http://allocineapi.codeplex.com/ | ||
| + | * 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 ===== | ||
| + | |||
| + | 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 [[:contact|formulaire de contact]] ou bien directement sur mon mail <jerome.groven@gmail.com> | ||
| + | |||
| + | ===== Remerciements ===== | ||
| - | Contactez moi via le [[:contact|formulaire de contact]] ou bien directement sur mon mail <jerome.groven@gmail.com>; | + | 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 ;-) |
| - | {{keywords>allocine api film films movie movies search recherche xml json movielist api.allocine.fr webservice webservices web service}} | + | {{keywords>allocine api film films movie movies search recherche xml json movielist api.allocine.fr webservice webservices web service série séries tv show tvshow}} |
| - | ~~UNDERCONSTRUCTION~~ | + | |
