« Documentation de l'API Jeuxvideo.com » : différence entre les versions

Version du 2 avril 2013 à 00:08

L'API de Jeuxvideo.com, utilisée à l'origine par les applications mobiles de Jeuxvideo.com, permet de développer plus facilement des applications, sites web, et autres scripts en rapport avec Jeuxvideo.com.

Elle est au format XML, ce qui fait qu'elle est plus facile à parser, mais aussi plus rapide à charger qu'une page web normale.

Identification

L'API utilise le nom de domaine ws.jeuxvideo.com. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Attention, ces identifiants peuvent changer à tout moment (c'est déjà arrivé).

	Utilisateur	Mot de passe
Android	app_and_gnw	FC?4554?
iPhone	app_ios_nw	W!P45-R

Utilisation

Connexion

Pour vous connecter, utilisez la page mon_compte/connexion.php.

Voici les paramètres à envoyer (GET ou POST) :

Paramètre	Valeur
newnom	Le pseudo de l'utilisateur.
stamp	Le timestamp (le nombre de secondes depuis le 1er janvier 1970) à l'heure où la requête est envoyée.
hash	Un hash MD5 sous la forme : md5(pseudo + motDePasse + "OpX234" + stamp) OpX234 est un salt.

NOTE : à l'heure où j'écris cet article, il est impossible de se connecter avec l'application Android, et donc depuis l'API. Le problème devrait être réglé bientôt.

Pour le renvoi de mot de passe, utilisez cette URL (en remplaçant Cisla par le pseudo ou bien l'adresse e-mail) :

http://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla

Jeux, astuces, news...

URL	Description
00.machines_version.xml	Dernière version de l'application et liste des consoles
01.flux_jeux_nouveautes.xml 01.flux_jeux_prochainement.xml	Listes de jeux
01.jeux/21963.xml 01.jeux/details/21963.xml 01.jeux/videos/21963.xml 01.jeux/screen/21963.xml 03.preview/43689.xml 03.test_complet/9813.xml 01.jeux/news/21963.xml 05.jeu_astuce/41030.xml 05.astuce/33258.xml	Informations sur le jeu (le nombre correspond à l'id)
03.dossier/18270.xml 03.dossier/18270/1.xml	Un dossier : 18270 est l'id du dossier, 1 est la page (si vous n'en mettez pas, vous avez le sommaire)
02.flux_news.xml 02.flux_news-4.xml	La liste des dernières news. Dans le deuxième exemple, en ajoutant le nombre 4, vous retournez 4 jours en arrière (ça peut aller jusqu'à 9)
03.flux_articles_tests.xml 03.flux_articles_tests-4.xml 03.flux_articles_apercus.xml 03.flux_articles_apercus-4.xml 03.flux_articles_dossier.xml 03.flux_articles_dossier-4.xml 04.flux_videos_cliq.xml 04.flux_videos_cliq-4.xml 04.flux_videos_gaming.xml 04.flux_videos_gaming-4.xml 04.flux_videos_autres.xml 04.flux_videos_autres-4.xml 05.flux_astuces.xml 05.flux_astuces-4.xml	Même chose pour les derniers articles, tests, astuces et aperçus
02.news_screen/1234.xml	Voir les screenshots associés à une news
ean.php?ean=0045496830144	Voir le jeu associé au code-barre (EAN) 0045496830144
forums_index.xml	Liste des forums généraux
search_n/mario search/mario search_sug/mario search_forums/mario search_forums_sug/mario	Effectuer une recherche dans le nom des jeux ou des forums

Forums

Pour les forums, les URL sont les mêmes que pour JVC, à part que :

Le .htm est transformé en .xml
Le www.jeuxvideo.com est remplacé par un ws.jeuxvideo.com
La chaîne de caractère à la fin de l'URL (comme blabla-15-18-ans ou nom-du-topic) est remplacée par un 0 (sauf pour la recherche).

Par exemple :
http://www.jeuxvideo.com/forums/0-50-0-1-0-1-0-blabla-15-18-ans.htm
Devient :
http://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

URL	Description
http://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml	La liste des sujets
http://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml	Rechercher « cactus » dans le titre des topics
http://ws.jeuxvideo.com/forums/1-50-88795466-1-0-1-0-0.xml	Un topic
http://ws.jeuxvideo.com/forums/2-50-0-1-0-1-0-0.xml	Formulaire pour créer un topic
http://ws.jeuxvideo.com/forums/3-50-88795466-1-0-1-0-0.xml	10 derniers messages d'un topic + formulaire
http://ws.jeuxvideo.com/forums/5-50-88795466-1-0-1-0-0.xml	Formulaire de réponse à un topic
http://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi	Envoi d'un message (avec les données POST)

Aux données de formulaires qui vous sont communiquées, vous devez ajouter (comme sur JVC normal) le paramètre yournewmessage pour le message et newsujet pour le titre du topic (si vous créez un nouveau topic). Même chose pour les captchas.

Vous devez être connecté (envoyer le cookie wenvjgol) pour récupérer et envoyer un formulaire.

Le même formulaire peut aussi bien être envoyé au forums.cgi de ws.jeuxvideo.com qu'à celui de www.jeuxvideo.com, ce qui vous permet de choisir entre apparaître « via mobile » ou non.

Messages privés

Cet article est en cours de rédaction, ces informations seront ajoutées plus tard.

Reverse-engineering