JVFlux - Contributions [fr]

Documentation de l'API Jeuxvideo.com

2025-06-29T10:20:58Z

HelloWorld5000 : correction d'informations devenues erronées

{{Bannière Info|Contenu=Cette page documente l'API v4 de jeuxvideo.com. Le fonctionnement du site est quant à lui détaillé sur [[Fonctionnement technique de Jeuxvideo.com]].}}

L''''API de [[jeuxvideo.com]]''', conçue par les développeurs du site pour l'application mobile, permet de programmatiser l'envoi de requêtes à JVC.
Étant à l'origine réservée à un usage privé, on ne dispose pas de sa documentation officielle. Toutefois, il est possible de détailler son fonctionnement grâce à un travail de rétro-ingéniérie.

En juin 2025, l'API est hébergée sur le sous-domaine ''api'', et est à sa quatrième version (''v4'').

L'ancienne API ''jvc.gg'' était hébergée à ''api.jvc.gg'' jusqu'à son abandon en février 2025. Elle était utilisée par les pages Phoenix du site, notamment pour la recherche des jeux. Sa documentation (non-officielle) est toujours consultable sur cet article.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=très probablement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

<div id="jvclient"></div>
=JVClient=
[[File:icon-512x512.png|vignette|256px|Le logo de JVClient : « Le pouvoir par les données ».]]

[https://www.npmjs.com/package/jv-client '''JVClient'''] est une '''librairie Node.js''' écrite en TypeScript qui fournit des classes et des fonctions permettant d'interagir avec l'API v4 de jeuxvideo.com ainsi que le site JVC lui-même.
Publiée en février 2025, son objectif est de servir de base aux programmeurs pour le ''scraping'' de données sur des jeux, articles, forums, topics, etc. et pour l'exécution d'opérations nécessitant un compte connecté (comme poster des topics). Le code est ''open source'' et disponible sur Github<ref>https://github.com/Contrapunctus-XIV/jv-client</ref>.

Elle dispose également d'une documentation complète<ref>https://contrapunctus-xiv.github.io/jv-client/</ref> qui explique en détail l'organisation des données de jeuxvideo.com.

{{clear}}

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine pour les forums ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable site Web, qui réplique les forums du site www.jeuxvideo.com : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>. Il manque cependant de nombreuses fonctionnalités comme les pages de profils sur le sous-domaine API.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints de service==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).
On rappelle que l'accès à ces ''endpoints'' nécessite un token d'authentification à fournir dans le header ''Jvc-Authorization''. Voir l'[[#annexe|annexe]] pour le générer.

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

'''Depuis mai 2025''', suite à une mise à jour de JVC, les informations ''"fs_" '', sont offusqués dans une chaîne en base 64.

Les fs_ sont récupérables via la balise script : ''window.jvc.forumsAppPayload''

<script>window.jvc=window.jvc||{};window.jvc.forumsAppPayload=[CHAINE_A_RECUPERER]</script>

Pour récupérer les valeurs dans la chaîne :
const forumsAppPayload = [...document.scripts].map(s => s.textContent.match(/forumsAppPayload\s*=\s*["']([^"']+)["']/)).filter(Boolean)[0][1];

const decoded = JSON.parse(atob(forumsAppPayload));

Auparavant, ces valeurs étaient disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' à l'URL avec le contenu du message en plus de ces dernières.

'''Pour poster un message''', la requête POST devra être faite à <code>https://www.jeuxvideo.com/forums/message/add</code> avec le ''header'' <code>Content-Type</code> valant <code>multipart/form-data</code> et les données suivantes en ''body'' :
<pre>
text : le contenu du message
topicId : ID du topic cible
topicTitle : titre du topic (si c'est une création du topic)
forumId : ID du forum cible
group : mettre à 1
messageId : undefined
toutes les clé/valeurs qui commencent par fs_ (à trouver selon la méthode donnée précédemment) + ajax_hash
</pre>

'''Pour poster un topic''', la requête POST devra être faite à <code>https://www.jeuxvideo.com/forums/topic/add</code> avec le ''header'' <code>Content-Type</code> valant <code>multipart/form-data</code> et les données suivantes en ''body'' :
<pre>
text : le contenu du message
topicId : mettre à 0
topicTitle : titre du topic (si c'est une création du topic)
forumId : ID du forum cible
group : mettre à 1
messageId : undefined
toutes les clé/valeurs qui commencent par fs_ (à trouver selon la méthode donnée précédemment) + ajax_hash
submitSurvey : true pour ajouter un sondage, false sinon
answerSurvey : titre du sondage s'il y en a un
responsesSurvey[] : une réponse au sondage
</pre>

'''Note''' : À date, ces informations sont uniquement offusquées dans la partie forum. Les messages privés conservent les informations en clair dans le HTML comme mentionné plus haut.

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}

[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API était une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle était hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

L'API est fermée début février 2025 à la suite de la refonte des pages Phoenix de JVC qui adoptent désormais le même fonctionnement que les autres pages du site.

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Documentation de l'API Jeuxvideo.com

2025-06-11T20:11:48Z

HelloWorld5000 : Retrait du script Python rendu obsolète par la mise à jour Cloudflare, pas d'alternative envisagée

{{Bannière Info|Contenu=Cette page documente l'API v4 de jeuxvideo.com. Le fonctionnement du site est quant à lui détaillé sur [[Fonctionnement technique de Jeuxvideo.com]].}}

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

<div id="jvclient"></div>
=JVClient=
[[File:icon-512x512.png|vignette|256px|Le logo de JVClient : « Le pouvoir par les données ».]]

[https://www.npmjs.com/package/jv-client '''JVClient'''] est une '''librairie Node.js''' écrite en TypeScript qui fournit des classes et des fonctions permettant d'interagir avec l'API v4 de jeuxvideo.com ainsi que le site JVC lui-même.
Publiée en février 2025, son objectif est de servir de base aux programmeurs pour le ''scraping'' de données sur des jeux, articles, forums, topics, etc. et pour l'exécution d'opérations nécessitant un compte connecté (comme poster des topics). Le code est ''open source'' et disponible sur Github<ref>https://github.com/Contrapunctus-XIV/jv-client</ref>.

Elle dispose également d'une documentation complète<ref>https://contrapunctus-xiv.github.io/jv-client/</ref> qui explique en détail l'organisation des données de jeuxvideo.com.

{{clear}}

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine pour les forums ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable site Web, qui réplique les forums du site www.jeuxvideo.com : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>. Il manque cependant de nombreuses fonctionnalités comme les pages de profils sur le sous-domaine API.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints de service==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).
On rappelle que l'accès à ces ''endpoints'' nécessite un token d'authentification à fournir dans le header ''Jvc-Authorization''. Voir l'[[#annexe|annexe]] pour le générer.

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

'''Depuis mai 2025''', suite à une mise à jour de JVC, les informations ''"fs_" '', sont offusqués dans une chaîne en base 64.

Les fs_ sont récupérables via la balise script : ''window.jvc.forumsAppPayload''

<script>window.jvc=window.jvc||{};window.jvc.forumsAppPayload=[CHAINE_A_RECUPERER]</script>

Pour récupérer les valeurs dans la chaîne :
const forumsAppPayload = [...document.scripts].map(s => s.textContent.match(/forumsAppPayload\s*=\s*["']([^"']+)["']/)).filter(Boolean)[0][1];

const decoded = JSON.parse(atob(forumsAppPayload));

Auparavant, ces valeurs étaient disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' à l'URL avec le contenu du message en plus de ces dernières.

'''Pour poster un message''', la requête POST devra être faite à <code>https://www.jeuxvideo.com/forums/message/add</code> avec le ''header'' <code>Content-Type</code> valant <code>multipart/form-data</code> et les données suivantes en ''body'' :
<pre>
text : le contenu du message
topicId : ID du topic cible
topicTitle : titre du topic (si c'est une création du topic)
forumId : ID du forum cible
group : mettre à 1
messageId : undefined
toutes les clé/valeurs qui commencent par fs_ (à trouver selon la méthode donnée précédemment) + ajax_hash
</pre>

'''Pour poster un topic''', la requête POST devra être faite à <code>https://www.jeuxvideo.com/forums/topic/add</code> avec le ''header'' <code>Content-Type</code> valant <code>multipart/form-data</code> et les données suivantes en ''body'' :
<pre>
text : le contenu du message
topicId : mettre à 0
topicTitle : titre du topic (si c'est une création du topic)
forumId : ID du forum cible
group : mettre à 1
messageId : undefined
toutes les clé/valeurs qui commencent par fs_ (à trouver selon la méthode donnée précédemment) + ajax_hash
submitSurvey : true pour ajouter un sondage, false sinon
answerSurvey : titre du sondage s'il y en a un
responsesSurvey[] : une réponse au sondage
</pre>

'''Note''' : À date, ces informations sont uniquement offusquées dans la partie forum. Les messages privés conservent les informations en clair dans le HTML comme mentionné plus haut.

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}

[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API était une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle était hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

L'API est fermée début février 2025 à la suite de la refonte des pages Phoenix de JVC qui adoptent désormais le même fonctionnement que les autres pages du site.

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Documentation de l'API Jeuxvideo.com

2025-06-10T19:23:00Z

HelloWorld5000 : /* Accès aux forums */ Mise à jour de mai 2025

{{Bannière Info|Contenu=Cette page documente l'API v4 de jeuxvideo.com. Le fonctionnement du site est quant à lui détaillé sur [[Fonctionnement technique de Jeuxvideo.com]].}}

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

<div id="jvclient"></div>
=JVClient=
[[File:icon-512x512.png|vignette|256px|Le logo de JVClient : « Le pouvoir par les données ».]]

[https://www.npmjs.com/package/jv-client '''JVClient'''] est une '''librairie Node.js''' écrite en TypeScript qui fournit des classes et des fonctions permettant d'interagir avec l'API v4 de jeuxvideo.com ainsi que le site JVC lui-même.
Publiée en février 2025, son objectif est de servir de base aux programmeurs pour le ''scraping'' de données sur des jeux, articles, forums, topics, etc. et pour l'exécution d'opérations nécessitant un compte connecté (comme poster des topics). Le code est ''open source'' et disponible sur Github<ref>https://github.com/Contrapunctus-XIV/jv-client</ref>.

Elle dispose également d'une documentation complète<ref>https://contrapunctus-xiv.github.io/jv-client/</ref> qui explique en détail l'organisation des données de jeuxvideo.com.

{{clear}}

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine pour les forums ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable site Web, qui réplique les forums du site www.jeuxvideo.com : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>. Il manque cependant de nombreuses fonctionnalités comme les pages de profils sur le sous-domaine API.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints de service==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).
On rappelle que l'accès à ces ''endpoints'' nécessite un token d'authentification à fournir dans le header ''Jvc-Authorization''. Voir l'[[#annexe|annexe]] pour le générer.

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

'''Depuis mai 2025''', suite à une mise à jour de JVC, les informations ''"fs_" '', sont offusqués dans une chaîne en base 64.

Les fs_ sont récupérables via la balise script : ''window.jvc.forumsAppPayload''

<script>window.jvc=window.jvc||{};window.jvc.forumsAppPayload=[CHAINE_A_RECUPERER]</script>

Pour récupérer les valeurs dans la chaîne :
const forumsAppPayload = [...document.scripts].map(s => s.textContent.match(/forumsAppPayload\s*=\s*["']([^"']+)["']/)).filter(Boolean)[0][1];

const decoded = JSON.parse(atob(forumsAppPayload));

Auparavant, ces valeurs étaient disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' à l'URL avec le contenu du message en plus de ces dernières.

'''Pour poster un message''', la requête POST devra être faite à <code>https://www.jeuxvideo.com/forums/message/add</code> avec le ''header'' <code>Content-Type</code> valant <code>multipart/form-data</code> et les données suivantes en ''body'' :
<pre>
text : le contenu du message
topicId : ID du topic cible
topicTitle : titre du topic (si c'est une création du topic)
forumId : ID du forum cible
group : mettre à 1
messageId : undefined
toutes les clé/valeurs qui commencent par fs_ (à trouver selon la méthode donnée précédemment) + ajax_hash
</pre>

'''Pour poster un topic''', la requête POST devra être faite à <code>https://www.jeuxvideo.com/forums/topic/add</code> avec le ''header'' <code>Content-Type</code> valant <code>multipart/form-data</code> et les données suivantes en ''body'' :
<pre>
text : le contenu du message
topicId : mettre à 0
topicTitle : titre du topic (si c'est une création du topic)
forumId : ID du forum cible
group : mettre à 1
messageId : undefined
toutes les clé/valeurs qui commencent par fs_ (à trouver selon la méthode donnée précédemment) + ajax_hash
submitSurvey : true pour ajouter un sondage, false sinon
answerSurvey : titre du sondage s'il y en a un
responsesSurvey[] : une réponse au sondage
</pre>

'''Note''' : À date, ces informations sont uniquement offusquées dans la partie forum. Les messages privés conservent les informations en clair dans le HTML comme mentionné plus haut.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}

[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API était une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle était hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

L'API est fermée début février 2025 à la suite de la refonte des pages Phoenix de JVC qui adoptent désormais le même fonctionnement que les autres pages du site.

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Sites et outils liés à jeuxvideo.com

2025-03-01T11:19:22Z

HelloWorld5000 : Ajout JVClient

Cette page liste tous les sites, outils et applications qui sont liés à jeuxvideo.com. '''Ils permettent d'enrichir votre expérience de navigation sur le site.'''

* Si vous souhaitez ajouter un projet vous êtes libre de le faire sans nous demander la permission
* Assurez vous seulement de bien respecter l'ordre alphabétique de chaque tableau, de remplir chaque colonne en vous inspirant des entrées actuelles et enfin veillez à ne pas casser la mise en forme des tableaux

'''Lien court vers cette page :''' <pre>https://jvflux.fr/Outils</pre>

== Projets ouverts ==

=== Sites ===

{|align="left" style="width:100%;" class="wikitable centre sortable"
! style="text-align:center"|Nom
! style="text-align:center"|Description
! style="text-align:center"|Lien
|-
|'''Boucled'''
|Des topics faits pour créer une boucle sur le 18-25
|[https://boucled.com/ boucled.com]
|-
|'''[[Clodo News]]'''
|L'info à travers des articles rédigés par des clodos pour des clodos
|[https://clodonews.com/ clodonews.com]
|-
|'''[[Combien.online]]'''
|Comparateur entre le cours du bitcoin et le nombre de connecté sur le [[Finance (forum)|forum Finance]]
|[https://combien.online/ combien.online]
|-
|'''[[Encyclopedia Noelica]]'''
|Le nouveau wiki des Noelistes
|[https://www.encyclopedianoelica.com/ encyclopedianoelica.com]
|-
|'''Flood Community'''
|Musée du flood sur les forums de jeuxvideo.com
|[http://floodcommunity.free.fr/home/ floodcommunity.free.fr]
|-
|'''[[gpa.lu]]'''
|Service d'adresses e-mail jetables pour les kheys
|[https://gpa.lu/ gpa.lu]
|-
|'''[[JvArchive]]'''
|Projet d'archivage du forum 18-25 de jeuxvideo.com
|[https://jvarchive.st/ jvarchive.st]
|-
|'''[[JVFlux]]'''
|Wiki qui centralise toutes les informations liées à JVC
|[https://jvflux.fr/ jvflux.fr]
|-
|'''Mosaïque NoelShack'''
|Créer une [[mosaïque]] NoelShack
|[http://nocturnex.alwaysdata.net/mosajax/ nocturnex.alwaysdata.net]
|-
|'''[[Noelfic]]'''
|Regroupement des fics et histoires publiées par les forumeurs
|[https://noelfic.jvflux.fr/ noelfic.jvflux.fr]
|-
|'''[[NoelSWF]]'''
|Animations flash de la communauté
|[https://noelswf.jvflux.fr/ noelswf.jvflux.fr]
|-
|'''[[Pandome]]'''
|Site crée par ''GeneralCoin'' pour y publier ses fics
|[https://www.pandome.fr/ pandome.fr]
|-
|'''[[Prolix TV]]'''
|Tutos pour économiser de l'argent
|[https://prolixtv.wordpress.com/ prolixtv.wordpress.com]
|-
|'''[[Risibank|RisiBank]]'''
|Banque de stickers humoristiques de k-litaient
|[https://risibank.fr/ risibank.fr]
|-
|'''[[Risific]]'''
|Les fics les plus légendaires du 18-25 en direct de ton canapé
|[https://risific.jvflux.fr/ risific.jvflux.fr]
|-
|'''Risishack'''
|Partagez des images et vidéos gratuitement
|[https://www.risishack.com/ risishack.com]
|-
|'''[[Risitest]]'''
|Test de personnalité destiné à la communauté du 18-25
|[https://risitest.fr/ risitest.fr]
|-
|'''[[Risitrade]]'''
|Visualiseur du cours du bitcoin en fonction des cris de Risitas.
|[https://risitrade.surge.sh/ risitrade.surge.sh]
|-
|'''Wiki [[Guerre des Consoles (forum)|Guerre des Consoles]]'''
|Wiki du forum Guerre des consoles
|[http://wikigdc.ovh/wiki/Accueil wikigdc.ovh]
|-
|'''Wiki [[Koh-Lanta du 18-25]]'''
|Wiki du jeu RP éponyme.
|[https://kl1825.fandom.com/fr/wiki/Wiki_Koh-Lanta_du_18-25 kl1825.fandom.com]
|}
{{clear}}

=== Scripts/Logiciels ===

{|align="left" style="width:100%;" class="wikitable centre sortable"
! style="text-align:center"|Nom
! style="text-align:center"|Description
! style="text-align:center"|Lien
|-
|'''[[Décensured]]'''
|Chiffre et masque vos messages afin d'éviter la censure abusive sur les forums JVC
|[https://github.com/Rand0max/decensured GitHub]
|-
|'''[[Déboucled]]'''
|Censure les topics et les auteurs de la boucle et plus encore
|[https://www.jeuxvideo.com/forums/42-51-68410257-1-0-1-0-officiel-deboucled-v2-est-arrive-fini-la-boucle-et-le-spam.htm Topic officiel]
|-
|'''JvArchive compagnon'''
|En installant l'userscript JvArchive compagnon, retrouvez la vie d'avant le 410 sur le 18-25
|https://jvarchive.com/userscript
|-
|'''[[JVFlux Compagnon]]'''
|Intégration des articles de JVFlux dans les messages
|[https://www.jeuxvideo.com/forums/42-51-68982055-1-0-1-0-officiel-jv-flux-compagnon-le-plugin-indispensable-du-forum.htm Topic officiel]
|-
|'''[[JVscript|JVScript]]'''
|Banque de scripts pour jeuxvideo.com
|[https://jvscript.fr/ jvscript.fr]
|-
|'''[[RespawnIRC]] (Android)'''
|Appli Android donnant une interface de client IRC aux topics de jeuxvideo.com
|[https://www.jeuxvideo.com/forums/42-1000005-49633519-1-0-1-0-app-respawnirc.htm Forum Communauté] / [https://github.com/FranckRJ/RespawnIRC-Android Sources sur GitHub]
|-
|'''[[RespawnIRC]] (PC)'''
|Logiciel donnant une interface de client IRC aux topics de jeuxvideo.com
|[https://www.jeuxvideo.com/forums/42-1000021-40573812-1-0-1-0-pc-android-respawnirc.htm Forum Communauté]
|-
|'''[[RisiBank|Risibank]]'''
|Intégration des stickers de Risibank sur l'interface de jeuxvideo.com
|https://risibank.fr/installer
|-
|'''TopicLive'''
|Charger automatiquement les nouveaux messages postés sur un topic
|[https://www.jeuxvideo.com/forums/42-1000021-37766371-1-0-1-0-script-topiclive-compatible-respawn.htm Forum Communauté]
|-
|'''[[API#jvclient|JVClient]]'''
|Librairie Node.js qui permet d'interagir avec jeuxvideo.com et son API v4.
|[https://github.com/Contrapunctus-XIV/jv-client Dépôt GitHub]
|}
{{clear}}

=== Chaines YouTube ===

{|align="left" style="width:100%;" class="wikitable centre sortable"
! style="text-align:center"|Nom
! style="text-align:center"|Description
! style="text-align:center"|Lien
|-
|'''[[Consul Pazen]]'''
|Chaine journalistique sur les dernières news zinzins
|[https://youtube.com/c/ConsulPazenLesNewsZinzins YouTube]
|-
|'''[[cutface]]'''
|cutface réalise avec amour des vidéos certifiées Éco+
|[https://www.youtube.com/channel/UCq9ppoOS3oiwJ8NUPudrb1g YouTube]
|-
|'''[[El Kekos]]'''
|Malaisologue certifié élevé en plein air
|[https://www.youtube.com/channel/UC4Dh79Ay7UrwucrUdFZpHWw YouTube]
|-
|'''[[Les Boxeurs de l'Elite]]'''
|Pratique de la boxe anglaise entre kheys
|[https://www.youtube.com/channel/UCQbB94fbone7qIkCIYwD51Q YouTube]
|-
|'''[[L'Œil de l'Elite]]'''
|L'Œil de l'Elite scrute le forum et ses perles
|[https://www.youtube.com/channel/UCWnoIqU2pQfbQ5TaHZallcA YouTube]
|-
|'''[[Loop Golem Killer]]'''
|Viens prendre ta dose de Live Looping Music
|[https://www.youtube.com/channel/UCbSJq5g9slW2W-drxZ_tEpw YouTube]
|-
|'''[[The French Dream]]'''
|Chaîne d'étude du French Dream et des Magalie
|[https://www.youtube.com/channel/UCy7M87IccrVnkASV0aNmDHw YouTube]
|}
{{clear}}

=== Comptes Twitter ===

{|align="left" style="width:100%;" class="wikitable centre sortable"
! style="text-align:center"|Nom
! style="text-align:center"|Description
! style="text-align:center"|Lien
|-
|'''[[Escadron Noeliste]]'''
|Pour la liberté d'expression et la préservation de la culture internet Française
|[https://twitter.com/EscadronNoelis1 @EscadronNoelis1]
|-
|'''[[jeuxvideo.com]]'''
|Compte officiel de jeuxvideo.com
|[https://twitter.com/JVCom @JVCom]
|-
|'''[[JVFlux]]'''
|JVFlux, Wiki de jeuxvideo.com & Noel SWF
|[https://twitter.com/JVFlux @JVFlux]
|-
|'''Le Meilleur Du 18-25'''
|Compte Twitter sur les meilleurs moments du 18-25
|[https://twitter.com/bestof_1825 @bestof_1825]
|-
|'''[[Noelradio]]'''
|NoelRadio est la webradio du forum Avenoel
|[https://twitter.com/radio_noel @radio_noel]
|-
|'''[[RisiCards|RisiCards Officiel]]'''
|RisiCards, le jeu de cartes officiel de l'Élite de la nation
|[https://twitter.com/risicards @risicards]
|}
{{clear}}
== JVC-Like ==

{|align="left" style="width:100%;" class="wikitable centre sortable"
! style="text-align:center"|Nom
! style="text-align:center"|Lien
! style="text-align:center"|Création
|-
|'''[[2Sucres]]'''
|[https://2sucres.org/ 2sucres.org]
|2017
|-
|'''[[Avenoel]]'''
|[https://avenoel.org/ avenoel.org]
|2014
|-
|'''[[Onche.org]]'''
|[https://onche.org/ onche.org]
|2018
|-
|'''[[NoelTopia]]'''
|[https://www.noeltopia.com/ noeltopia.com]
|2019
|}
{{clear}}
==Sites issus de la communauté==
Les sites suivants n'ont rien à voir avec jeuxvideo.com mais ont été ouverts et sont tenus par des forumeurs issus de la communauté.
{|align="left" style="width:100%;" class="wikitable centre sortable"
! style="text-align:center"|Nom
! style="text-align:center"|Description
! style="text-align:center"|Lien
|-
|'''[[StopFap]]'''
|StopFap est un réseau social anonyme d'entraide pour combattre l'addiction au porno et la masturbation compulsive
|[https://www.stopfap.org/ stopfap.org]
|-
|'''[[Orbitum]]'''
|Plateforme de discussion orientée vers les cryptomonnaies et la finance décentralisée
|[https://orbitum.space/ orbitum.space]
|}
{{clear}}
== Projets fermés ==

{|align="left" style="width:100%;" class="wikitable centre sortable"
! style="text-align:center"|Nom
! style="text-align:center"|Description
! style="text-align:center"|Lien
! style="text-align:center"|Type
! style="text-align:center"|Dates
|-
|'''@1825_JVCom'''
|Compte Twitter officiel du Blabla 18-25 ans de JVC
|[https://twitter.com/1825_JVCom twitter.com/1825_JVCom]
|Compte Twitter
|2015 – 2016
|-
|'''[[Bruiter]]'''
|Clonage des topics du 18-25
|[https://bruiter.com/ bruiter.com] (lien mort)
|Site
|2018 – 2020
|-
|'''[[Gazette de JVC]]'''
|Journal sur l'actualité des forums
|[https://www.jeuxvideo.com/recherche/forums/0-1000021-0-1-0-1-0-communaute.htm?search_in_forum=gazette&type_search_in_forum=titre_topic Forum Communauté]
[http://www.gazettejv.com/ gazettejv.com] (lien mort)
|Site
|2008 – 2015
|-
|'''[[JVFlux]]'''
|Journal sur l'actualité des forums
|[https://archives.jvflux.fr archives.jvflux.fr]
|Site
|2009 – 2015
|-
|'''[[JVCMaster]]'''
|Amélioration de la navigation sur les forums
|[https://www.jeuxvideo.com/forums/1-1000021-1273221-1-0-1-0-extension-jvcmaster.htm Forum Communauté]
|Extension
|2012 – 2015
|-
|'''[[JV.Nyu]]'''
|Amélioration de la navigation sur les forums
|[https://www.jeuxvideo.com/forums/1-1000021-394126-1-0-1-0-outil-jvn-jeuxvideo-nyu-v1-1.htm Forum Communauté]
|Extension
|2009 – 2011
|-
|'''[[JVStats|JV Stats]]'''
|Statistiques des forums de jeuxvideo.com
|[http://jvstats.forum-stats.org/stats/1/ jvstats.forum-stats.org] (lien mort)
|Site
|2001 – 2019
|-
|'''[[Noelpedia|NoelPedia]]'''
|Ancienne encyclopédie Noeliste
|[http://floodcommunity.free.fr/home/wikiaFlood/www.noelpedia.com/index481b.html?title=Accueil floodcommunity.free.fr] (archive incomplète)
[https://web.archive.org/web/20110129041433/http://www.noelpedia.com/index.php?title=Accueil archive.org] (archive incomplète)
|Site
|2008 – 2011
|-
|'''[[Risific]]'''
|Consultation des fics créées par les membres de la communauté
|[https://risific.fr/ risific.fr] (lien mort)
[https://web.archive.org/web/20210420082447/https://risific.fr/ archive.org] (archives)
|Site
|2017 – 2021
|}
{{clear}}

{{SectionRéférences}}
[[Catégorie:Site de la kheyosphère]]
[[Catégorie:Extensions et outils]]
{{TableauCatégorieSitesCommu}}

Documentation de l'API Jeuxvideo.com

2025-03-01T11:18:36Z

HelloWorld5000 : Div anchor sur JVClient

{{Bannière Info|Contenu=Cette page documente l'API v4 de jeuxvideo.com. Le fonctionnement du site est quant à lui détaillé sur [[Fonctionnement technique de Jeuxvideo.com]].}}

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

<div id="jvclient"></div>
=JVClient=
[[File:icon-512x512.png|vignette|256px|Le logo de JVClient : « Le pouvoir par les données ».]]

[https://www.npmjs.com/package/jv-client '''JVClient'''] est une '''librairie Node.js''' écrite en TypeScript qui fournit des classes et des fonctions permettant d'interagir avec l'API v4 de jeuxvideo.com ainsi que le site JVC lui-même.
Publiée en février 2025, son objectif est de servir de base aux programmeurs pour le ''scraping'' de données sur des jeux, articles, forums, topics, etc. et pour l'exécution d'opérations nécessitant un compte connecté (comme poster des topics). Le code est ''open source'' et disponible sur Github<ref>https://github.com/Contrapunctus-XIV/jv-client</ref>.

Elle dispose également d'une documentation complète<ref>https://contrapunctus-xiv.github.io/jv-client/</ref> qui explique en détail l'organisation des données de jeuxvideo.com.

{{clear}}

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine pour les forums ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable site Web, qui réplique les forums du site www.jeuxvideo.com : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>. Il manque cependant de nombreuses fonctionnalités comme les pages de profils sur le sous-domaine API.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints de service==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).
On rappelle que l'accès à ces ''endpoints'' nécessite un token d'authentification à fournir dans le header ''Jvc-Authorization''. Voir l'[[#annexe|annexe]] pour le générer.

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}

[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API était une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle était hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

L'API est fermée début février 2025 à la suite de la refonte des pages Phoenix de JVC qui adoptent désormais le même fonctionnement que les autres pages du site.

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Fonctionnement technique de Jeuxvideo.com

2025-03-01T11:16:19Z

HelloWorld5000 : Bannière info (lien vers API)

{{Bannière Info|Contenu=Cette page détaille le fonctionnement technique de jeuxvideo.com. L'API v4 du site est quant à elle documentée sur [[Documentation de l'API Jeuxvideo.com]].}}

== Introduction ==
[[Jeuxvideo.com]] utilise 2 serveurs frontaux qui sont depuis le 7 mai 2022 protégés par le service [https://cloudflare.com Cloudflare]. Chaque serveur frontal utilise un serveur HTTP Apache, tout ce qu'il y a de plus classique. En revanche, avant d'arriver sur le serveur Apache, on a plusieurs mailles dans la chaîne. En effet, lorsque vous faites une requête auprès de JVC, la chaîne suivante est effectuée avant d'arriver jusqu'au back-end :
Cloudflare → Round-robin entre les 2 serveurs frontaux → HAProxy → Varnish → Apache → PHP / Express (Node.js)

== Processus d'une requête HTTP ==

'''Cloudflare''' est le premier point d'entrée pour accéder à JVC. Il gère les enregistrements DNS du site et ses IPs sont majoritairement aléatoires et anycastées/géocastées. Ce service touche la couche réseau/transport tout comme la couche applicative du modèle OSI : il fait office d'anti-DDoS à forte valeur (bien que JVC utilise le service "Volterra" en tant qu'anti-DDoS sur couches basses du côté des IPs de son AS 35717). Une partie de la couche applicative est protégée par Cloudflare, via des règles éditées manuellement par [[Webedia]] (entre autre, blocages de pools IPv4 de VPN connus, et de certains pays d'après certains retours d'utilisateurs).

Un round-robin est effectué via Cloudflare auprès des serveurs DNS de Webedia. Le but est de déterminer de façon algorithmique quel serveur frontal va être utilisé pour la requête HTTP.

'''HAProxy''' est un proxy et load-balancer TCP d'une efficacité remarquable, il est utilisé sur la totalité des environnements de production gérés par Webedia. C'est entre autre ce service à l'origine de l'erreur 403 Forbidden. En effet, HAProxy fait aussi office de protection applicative (on peut donc en déduire que JVC utilise plusieurs services sur couche haute pour protéger l'applicatif). On peut notamment remarquer le blacklistage des IPs du réseau "Tor", mais également le blacklistage des pools de l'AS 16276 (appartenant à la société OVH et n'étant utilisé que dans des contextes d'hébergement) - blocage mené suite à l'utilisation massive des services de la société OVH dans le but de scrapper/attaquer JVC.

'''Apache''' est un serveur HTTP. Il a été optimisé par l'équipe technique actuelle de Webedia, mais également par l'ancienne équipe du site (on peut notamment citer [[Dargor]] et [[Haazel]] en tant que personnes ayant participées à l'élaboration de tunning du serveur HTTP).

Le dernier point est selon la page qui est demandée. Des parties du site sont développées en PHP, et d'autres en Node.js. Pour l'anecdote, le site est hébergé côté serveur dans le dossier /opt/datas/sites/JEUXVIDEO.COM/<ref>La norme [https://fr.wikipedia.org/wiki/Filesystem_Hierarchy_Standard Filesystem Hierarchy Standard] n’incluait pas <code>/srv</code>, qui est plus approprié, avant 2004.</ref>. Il n'y a quasiment aucune protection de ce côté (si ce n'est une protection contre les IPs Tor).

=== Protection applicative Cloudflare ===

L'applicatif est donc, comme on a pu le voir, protégé par Cloudflare en premier point d'entrée. Cloudflare est binaire : si l'IP source est blacklistée, une HTTP 403 est retournée et l'accès à l'URI est refusé. Le blocage est en outre simple à bypasser, pour le moment, on peut constater que l'usage d'IPs géolocalisées en France est un bon bypass.

=== Domaine de fichiers statiques ===

'''static.jvc.gg''' est notamment utilisé pour servir les feuilles de styles et scripts et utilise comme serveur '''nginx''' au lieu d'Apache. N’étant pas protégé par Cloudflare en janvier 2023 il permet d’avoir un aperçu technique de comment était servi l’ensemble du site avant la mise en place de Cloudflare.

Côté DNS, cinq serveurs de noms sont utilisés : ns1.webedia-group.org, ns2.webedia-group.net, ns3.webedia-group.com, ns4.webedia-group.biz, ns5.webedia-group.app. Les deux premiers sont sur leur AS 35717 ; les trois derniers sont respectivement hébergés chez Scaleway, OVH, Gandi.

== Avant Respawn ==

Avant [[Projet Respawn|Respawn]], JVC était développé sur plusieurs langages différents côté back-end : on peut citer le C et le PHP. La base de données finale utilisait le moteur de base de données PostgreSQL. L'anarchie technique du back-end a menée au développement de [[Respawn]] (qui est également anarchique).

=== Les Cartes de visite ===

Les [[Carte de Visite|Cartes de visite]] étaient développés en PHP et avaient la particularité notable de stocker les données publiques de chaque utilisateur (par exemple, sa description personnelle) dans de simples fichiers HTML stockés sur disque : il n'y avait pas de requête SQL d'invoquée pour obtenir certaines données liées aux CDV. Lors de certains floods d'avis utilisateurs (notamment menés par ''UnifiedLinux''), les CDV retournaient aléatoirement des pages blanches. La cause est toujours inconnue.

=== Les forums ===

Les forums étaient en C, et [[Dargor]] les nommaient "modulaires".

=== Les articles ===

Les articles n'étaient pas mis en ligne immédiatement après leur rédaction. Un système de "compilation" était nécessaire et à effectuer manuellement afin que le site "compile" les articles pour qu'ils deviennent accessibles au public. On peut imaginer que ce système de compilation a été développé dans un but de gestion de charge applicative.

=== Modération ===

La modération des forums était liée à une authentification à 2 étapes, menant à l'attribution du cookie [[mocoedivxuejdom]] permettant la modération de certains forums selon les permissions attribuées à chaque modérateur. Cette deuxième étape était une page spéciale réclamant 5 mots de passe, qui avaient la particularité d'être remplis de caractères aléatoires et spéciaux.

=== Authentification ===

Le cookie [[wenvjgol]] était utilisé pour l'authentification.

=== La recherche des forums ===

La recherche des forums était connue pour être atrocement lente et affichant incorrectement la liste des résultats, des topics étaient manquants et s'affichaient une fois sur deux.

=== Sécurité informatique ===

Lorsqu'une IP tentait d'envoyer trop de requêtes HTTP (HTTPS n'était pas déployé à ce moment-là), le site redirigeait chaque requête HTTP vers une erreur 404. La page d'erreur 404 étant très peu consommatrice techniquement, cela permettait de désaturer la charge serveur en cas de DoS/DDoS.

Sur les CDV et les forums, il y a eu un grand nombre de failles XSS, notamment exploitées en masse par [[PyjamaSam]].

Le [[Captcha]] était également tout le temps cassé, permettant des floods de topics/messages/contributions. Cela a permis par exemple de créer un pseudo rang rubis en moins d'un jour, dont le pseudo était ''RubyOne'' (par ''UnifiedLinux'', qui a également créé un pseudo rang diamant en moins d'un jour via un flood de contributions).

== Respawn ==

[[Respawn]] a été développé entièrement en PHP côté back-end. Il utilise notamment des frameworks tels que Symfony côté forums, et des moteurs de templates tel que Twig. Respawn semble être divisé techniquement en plusieurs parties : en effet, on peut constater que certaines parties du site respectent le modèle vue-contrôleur (on peut citer les forums), bien que d'autres parties du site n'utilisent pas ce modèle et utilisent de l'url rewriting hardcodé dans des fichiers .htaccess. Respawn semble posséder une base de code identique entre JVC et [[ForumJV]] (désormais fermé), on pouvait constater de nettes interactions entre les 2 sites lorsque ForumJV était ouvert, interactions ayant menées à certains abus (ForumJV accordait des droits de modération sur son forum personnel, des failles de sécurité était donc existantes derrière ce privilège).

=== Schéma de base de données ===

Le schéma de base de données de Respawn semble anarchique et composé de mélange entre le Français et l'Anglais. Exemples de tables appartenant à Respawn : "get_compte_infos", "session_renew_v2", "jeu_get_v7". Notez le "v" à la fin de chaque table, laissant penser qu'il existe plusieurs versions de celles-ci.

==== Exemple d'appel en base de données ====
''SELECT out_id_type, out_nom_type, out_dirname_type, out_affichage, out_date_publication, out_date_modification, out_id_alias_auteur, out_id_groupe_auteur, out_ip, out_titre, out_texte, out_commentaire, out_visibilite, out_liaisons, out_tags, out_medias, out_version, out_fiche, out_jeu, out_data, out_url, out_id_jeux FROM jeu_get_v7 WHERE id_contenu = xxx''

=== Organisation technique ===

Comme dit précédemment, Respawn semble être un mélange de MVC et de code classique sans modèle particulier de respecté. Les fichiers du back-end sont également mitigés du côté de leur appellation, laissant encore droit au mélange entre Français et Anglais. Exemples de fichiers côté back-end :

''/opt/datas/JEUXVIDEO.COM/htdocs/forums/liste_topic.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/core/OiPDOStatement.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Transaction.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/GoogleTagManager.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Compte.php'' 
''/opt/datas/JEUXVIDEO.COM/app/controllers/forum/liste_topic.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Session.php'' 
''/opt/datas/JEUXVIDEO.COM/app/vendor/...''

=== Nommage des fonctions ===

Respawn possède aussi des fonctions dont le nommage est entre le Français et l'Anglais. Exemples de fonctions côté back-end :

''getInfoFromIdForum'' 
''loadMenu'' 
''checkMenuItem'' 
''getSingleton'' 
''getHtmlJeuForum'' 
''blocHtmlBoutiqueRandom''

=== Optimisations ===

Le back-end PHP utilise Memcache (https://www.php.net/manual/fr/book.memcache.php) afin de faire baisser la charge technique de l'applicatif.

=== Stockage des utilisateurs ===

Depuis Respawn, les utilisateurs de JVC sont référencés sous un identifiant numérique côté base de données, contrairement au fonctionnement de l'ancien JVC où les utilisateurs étaient référencés par leur pseudo (pouvant mener à des posts sur les forums avec des pseudos identiques organisés différemment côté minuscules/majuscules).

Il est possible d'obtenir son ID via la page permettant d'éditer votre profil, l'ID est à la fin de l'URL.

=== Les forums ===

Les posts des forums sont déclarés sur plusieurs serveurs différents. Les IDs de ceux-ci semblent aléatoires (bien qu'un offset était attribué pour les posts présents sur ForumJV). Les IDs sont choisis selon l'emplacement dans lequel la ressource sera stockée lors de la création du topic. Le choix de l'emplacement se fait à la création du topic, les messages dans le topic sont alors stockés dans le même emplacement. Il semblerait qu'il y ait 8 emplacements. ID + 8 pour accéder à la ressource suivante, et ID - 8 pour accéder à la ressource précédente.

Exemple de messages séquentiels:

* https://www.jeuxvideo.com/forums/message/905193382
* https://www.jeuxvideo.com/forums/message/905193390
* https://www.jeuxvideo.com/forums/message/905193398

L'ID est incrémenté de 8 à chaque fois. Tous ces messages sont répertoriés dans le 7ème serveur (<code>ID % 8</code>, donc <code>905193382 % 8 = 6</code>, 7ème).

À noter toutefois que les messages datant d'avant respawn sont complètement désordonnés, certainement dû à la migration durant respawn où la migration de ces messages a été effectué en parallèle.

=== Modération ===

La modération sur Respawn se nomme "Accès étendu". L'accès étendu peut être appelé via la page qui lui est dédiée : https://www.jeuxvideo.com/sso/auth.php ; il nécessite en revanche également un mot de passe, qui est envoyé via un lien sécurisé utilisable une seule fois par MP à chaque modérateur. A noter que le [[103]] est accessible à n'importe quel modérateur même sans authentification à l'accès étendu.

=== Authentification ===

Le cookie [[coniunctio]] est utilisé pour l'authentification.

=== Recherche des forums ===

La recherche des forums utilise le moteur de recherche Sphinx qui est intégré au site. La recherche des forums est limitée à 1 mois sur les blablas, elle peut être contournée via https://jvarchive.com/.

=== Sécurité informatique ===

Dans les débuts de Respawn, le site était rempli de failles permettant de faire exploser la charge du site. Il existait également de nombreuses failles sur [[ForumJV]] qui permettaient de modérer sans être modérateur, sur n'importe quel forum. Les failles ici citées ont en majorité été exploitées par [[edwado]].

Il a également existé une faille RCE (Remote Code Execution) exploitée par [[Tsain]], qui permettait d'injecter du CSS sur n'importe quelle partie du site (la faille fut très mal exploitée étant-donné que celle-ci n'était pas qu'une simple injection CSS mais bien une RCE où il était possible d'injecter un shell PHP).

=== JvCare ===

JvCare est un algorithme d'obfuscation des liens externes postés sur le site. Il a été développé depuis Respawn. Il permet d'éviter la création de backlinks qui pourraient optimiser indirectement le SEO de sites externes à Jeuxvideo.com.

Les codes ci-après permettent de décoder une chaîne obfusquée.

==== PHP ====

function jvCare(string $classe) : string {
static $base16 = "0A12B34C56D78E9F";
$lien = "";
$s = explode(" ", $classe)[1];
for ($i = 0; $i < strlen($s); $i += 2) {
$lien .= chr(strrpos($base16, $s[$i]) * 16 + strrpos($base16, $s[$i + 1]));
}
return $lien;
}

==== JavaScript ====

function jvCake(classe) {
const base16 = '0A12B34C56D78E9F';
let lien = <nowiki>''</nowiki>;
const s = classe.split(' ')[1];
for (let i = 0; i < s.length; i += 2) {
lien += String.fromCharCode(base16.indexOf(s.at(i)) * 16 + base16.indexOf(s.at(i + 1)));
}
return lien;
}

===== Fonctionnel =====

function jvCake(classe) {
const base16 = '0A12B34C56D78E9F';
const s = classe.split(' ')[1];
const codeUnits = s
.match(/../g)
.map((i) => base16.indexOf(i[0]) * 16 + base16.indexOf(i[1]));
return String.fromCharCode(...codeUnits);
}

==== Python ====

def jvcare(classe: str) -> str:
base16 = '0A12B34C56D78E9F'
s = classe.split()[1]
url = <nowiki>''</nowiki>
for i, j in zip(s[0::2], s[1::2]):
url += chr(base16.index(i) * 16 + base16.index(j))
return url

===== Liste en compréhension =====

def jvcare(classe: str) -> str:
base16 = '0A12B34C56D78E9F'
s = classe.split()[1]
return <nowiki>''</nowiki>.join([chr(base16.index(i) * 16 + base16.index(j)) for i, j in zip(s[0::2], s[1::2])])

==== C ====

#include <stdlib.h>
#include <string.h>

const char *__jvcarebase16 = "0A12B34C56D78E9F";

char *jvcare(const char *class) {
char *s = strchr(class, ' ') + 1;

int urllen = strlen(s) / 2;
char *url = malloc(urllen + 1);
for (int i = 0; i < urllen; i++) {
char pos1 = strchr(__jvcarebase16, s[i * 2]) - __jvcarebase16;
char pos2 = strchr(__jvcarebase16, s[i * 2 + 1]) - __jvcarebase16;
url[i] = pos1 * 16 + pos2;
}
url[urllen] = '\0';
return url;
}

==== Awk ====

BEGIN {
base16 = "0A12B34C56D78E9F"
}
{
s = $2
for (i = 1; i < length(s); i += 2) {
pos1 = index(base16, substr(s, i, 1))
pos2 = index(base16, substr(s, i + 1, 1))
url = url sprintf("%c", (pos1 - 1) * 16 + (pos2 - 1))
}
print url
}

== Phoenix ==

Phoenix était une partie de JVC développée en Node.js et utilisant React. De plus en plus abandonnée au fil du temps, elle était utilisée pour afficher la liste des jeux et des contenus de la rédaction. Phoenix utilisait une API spéciale hébergée au sous-domaine [[Documentation_de_l%27API_Jeuxvideo.com#API_jvc.gg|''api.jvc.gg'']]. Phoenix ainsi que l'API GG disparaissent en février 2025 et les pages qu'elles servaient sont basculées vers la partie principale du site.

== Liens externes ==

* [http://www.journaldunet.com/solutions/itws/050426_it_jeuxvideo.shtml Interview sur l’architecture de jeuxvideo.com de 1997 à 2005] ([http://web.archive.org/web/20070629165914/http://www.journaldunet.com/solutions/itws/050426_it_jeuxvideo.shtml archive.org])

== Notes ==

<references />

== Voir aussi ==

* [[Documentation de l'API Jeuxvideo.com]]

{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Documentation de l'API Jeuxvideo.com

2025-03-01T11:14:40Z

HelloWorld5000 : Bannière info (lien vers fonctionnement du site)

{{Bannière Info|Contenu=Cette page documente l'API v4 de jeuxvideo.com. Le fonctionnement du site est quant à lui détaillé sur [[Fonctionnement technique de Jeuxvideo.com]].}}

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=JVClient=
[[File:icon-512x512.png|vignette|256px|Le logo de JVClient : « Le pouvoir par les données ».]]

[https://www.npmjs.com/package/jv-client '''JVClient'''] est une '''librairie Node.js''' écrite en TypeScript qui fournit des classes et des fonctions permettant d'interagir avec l'API v4 de jeuxvideo.com ainsi que le site JVC lui-même.
Publiée en février 2025, son objectif est de servir de base aux programmeurs pour le ''scraping'' de données sur des jeux, articles, forums, topics, etc. et pour l'exécution d'opérations nécessitant un compte connecté (comme poster des topics). Le code est ''open source'' et disponible sur Github<ref>https://github.com/Contrapunctus-XIV/jv-client</ref>.

Elle dispose également d'une documentation complète<ref>https://contrapunctus-xiv.github.io/jv-client/</ref> qui explique en détail l'organisation des données de jeuxvideo.com.

{{clear}}

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine pour les forums ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable site Web, qui réplique les forums du site www.jeuxvideo.com : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>. Il manque cependant de nombreuses fonctionnalités comme les pages de profils sur le sous-domaine API.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints de service==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).
On rappelle que l'accès à ces ''endpoints'' nécessite un token d'authentification à fournir dans le header ''Jvc-Authorization''. Voir l'[[#annexe|annexe]] pour le générer.

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}

[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API était une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle était hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

L'API est fermée début février 2025 à la suite de la refonte des pages Phoenix de JVC qui adoptent désormais le même fonctionnement que les autres pages du site.

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Fonctionnement technique de Jeuxvideo.com

2025-03-01T11:10:32Z

HelloWorld5000 : Retrait bannière, disparition de Phoenix

Cette page détaille le '''fonctionnement technique''' du site jeuxvideo.com. La documentation de l'API v4 du site est quant à elle disponible [[API|ici]].

== Introduction ==
[[Jeuxvideo.com]] utilise 2 serveurs frontaux qui sont depuis le 7 mai 2022 protégés par le service [https://cloudflare.com Cloudflare]. Chaque serveur frontal utilise un serveur HTTP Apache, tout ce qu'il y a de plus classique. En revanche, avant d'arriver sur le serveur Apache, on a plusieurs mailles dans la chaîne. En effet, lorsque vous faites une requête auprès de JVC, la chaîne suivante est effectuée avant d'arriver jusqu'au back-end :
Cloudflare → Round-robin entre les 2 serveurs frontaux → HAProxy → Varnish → Apache → PHP / Express (Node.js)

== Processus d'une requête HTTP ==

'''Cloudflare''' est le premier point d'entrée pour accéder à JVC. Il gère les enregistrements DNS du site et ses IPs sont majoritairement aléatoires et anycastées/géocastées. Ce service touche la couche réseau/transport tout comme la couche applicative du modèle OSI : il fait office d'anti-DDoS à forte valeur (bien que JVC utilise le service "Volterra" en tant qu'anti-DDoS sur couches basses du côté des IPs de son AS 35717). Une partie de la couche applicative est protégée par Cloudflare, via des règles éditées manuellement par [[Webedia]] (entre autre, blocages de pools IPv4 de VPN connus, et de certains pays d'après certains retours d'utilisateurs).

Un round-robin est effectué via Cloudflare auprès des serveurs DNS de Webedia. Le but est de déterminer de façon algorithmique quel serveur frontal va être utilisé pour la requête HTTP.

'''HAProxy''' est un proxy et load-balancer TCP d'une efficacité remarquable, il est utilisé sur la totalité des environnements de production gérés par Webedia. C'est entre autre ce service à l'origine de l'erreur 403 Forbidden. En effet, HAProxy fait aussi office de protection applicative (on peut donc en déduire que JVC utilise plusieurs services sur couche haute pour protéger l'applicatif). On peut notamment remarquer le blacklistage des IPs du réseau "Tor", mais également le blacklistage des pools de l'AS 16276 (appartenant à la société OVH et n'étant utilisé que dans des contextes d'hébergement) - blocage mené suite à l'utilisation massive des services de la société OVH dans le but de scrapper/attaquer JVC.

'''Apache''' est un serveur HTTP. Il a été optimisé par l'équipe technique actuelle de Webedia, mais également par l'ancienne équipe du site (on peut notamment citer [[Dargor]] et [[Haazel]] en tant que personnes ayant participées à l'élaboration de tunning du serveur HTTP).

Le dernier point est selon la page qui est demandée. Des parties du site sont développées en PHP, et d'autres en Node.js. Pour l'anecdote, le site est hébergé côté serveur dans le dossier /opt/datas/sites/JEUXVIDEO.COM/<ref>La norme [https://fr.wikipedia.org/wiki/Filesystem_Hierarchy_Standard Filesystem Hierarchy Standard] n’incluait pas <code>/srv</code>, qui est plus approprié, avant 2004.</ref>. Il n'y a quasiment aucune protection de ce côté (si ce n'est une protection contre les IPs Tor).

=== Protection applicative Cloudflare ===

L'applicatif est donc, comme on a pu le voir, protégé par Cloudflare en premier point d'entrée. Cloudflare est binaire : si l'IP source est blacklistée, une HTTP 403 est retournée et l'accès à l'URI est refusé. Le blocage est en outre simple à bypasser, pour le moment, on peut constater que l'usage d'IPs géolocalisées en France est un bon bypass.

=== Domaine de fichiers statiques ===

'''static.jvc.gg''' est notamment utilisé pour servir les feuilles de styles et scripts et utilise comme serveur '''nginx''' au lieu d'Apache. N’étant pas protégé par Cloudflare en janvier 2023 il permet d’avoir un aperçu technique de comment était servi l’ensemble du site avant la mise en place de Cloudflare.

Côté DNS, cinq serveurs de noms sont utilisés : ns1.webedia-group.org, ns2.webedia-group.net, ns3.webedia-group.com, ns4.webedia-group.biz, ns5.webedia-group.app. Les deux premiers sont sur leur AS 35717 ; les trois derniers sont respectivement hébergés chez Scaleway, OVH, Gandi.

== Avant Respawn ==

Avant [[Projet Respawn|Respawn]], JVC était développé sur plusieurs langages différents côté back-end : on peut citer le C et le PHP. La base de données finale utilisait le moteur de base de données PostgreSQL. L'anarchie technique du back-end a menée au développement de [[Respawn]] (qui est également anarchique).

=== Les Cartes de visite ===

Les [[Carte de Visite|Cartes de visite]] étaient développés en PHP et avaient la particularité notable de stocker les données publiques de chaque utilisateur (par exemple, sa description personnelle) dans de simples fichiers HTML stockés sur disque : il n'y avait pas de requête SQL d'invoquée pour obtenir certaines données liées aux CDV. Lors de certains floods d'avis utilisateurs (notamment menés par ''UnifiedLinux''), les CDV retournaient aléatoirement des pages blanches. La cause est toujours inconnue.

=== Les forums ===

Les forums étaient en C, et [[Dargor]] les nommaient "modulaires".

=== Les articles ===

Les articles n'étaient pas mis en ligne immédiatement après leur rédaction. Un système de "compilation" était nécessaire et à effectuer manuellement afin que le site "compile" les articles pour qu'ils deviennent accessibles au public. On peut imaginer que ce système de compilation a été développé dans un but de gestion de charge applicative.

=== Modération ===

La modération des forums était liée à une authentification à 2 étapes, menant à l'attribution du cookie [[mocoedivxuejdom]] permettant la modération de certains forums selon les permissions attribuées à chaque modérateur. Cette deuxième étape était une page spéciale réclamant 5 mots de passe, qui avaient la particularité d'être remplis de caractères aléatoires et spéciaux.

=== Authentification ===

Le cookie [[wenvjgol]] était utilisé pour l'authentification.

=== La recherche des forums ===

La recherche des forums était connue pour être atrocement lente et affichant incorrectement la liste des résultats, des topics étaient manquants et s'affichaient une fois sur deux.

=== Sécurité informatique ===

Lorsqu'une IP tentait d'envoyer trop de requêtes HTTP (HTTPS n'était pas déployé à ce moment-là), le site redirigeait chaque requête HTTP vers une erreur 404. La page d'erreur 404 étant très peu consommatrice techniquement, cela permettait de désaturer la charge serveur en cas de DoS/DDoS.

Sur les CDV et les forums, il y a eu un grand nombre de failles XSS, notamment exploitées en masse par [[PyjamaSam]].

Le [[Captcha]] était également tout le temps cassé, permettant des floods de topics/messages/contributions. Cela a permis par exemple de créer un pseudo rang rubis en moins d'un jour, dont le pseudo était ''RubyOne'' (par ''UnifiedLinux'', qui a également créé un pseudo rang diamant en moins d'un jour via un flood de contributions).

== Respawn ==

[[Respawn]] a été développé entièrement en PHP côté back-end. Il utilise notamment des frameworks tels que Symfony côté forums, et des moteurs de templates tel que Twig. Respawn semble être divisé techniquement en plusieurs parties : en effet, on peut constater que certaines parties du site respectent le modèle vue-contrôleur (on peut citer les forums), bien que d'autres parties du site n'utilisent pas ce modèle et utilisent de l'url rewriting hardcodé dans des fichiers .htaccess. Respawn semble posséder une base de code identique entre JVC et [[ForumJV]] (désormais fermé), on pouvait constater de nettes interactions entre les 2 sites lorsque ForumJV était ouvert, interactions ayant menées à certains abus (ForumJV accordait des droits de modération sur son forum personnel, des failles de sécurité était donc existantes derrière ce privilège).

=== Schéma de base de données ===

Le schéma de base de données de Respawn semble anarchique et composé de mélange entre le Français et l'Anglais. Exemples de tables appartenant à Respawn : "get_compte_infos", "session_renew_v2", "jeu_get_v7". Notez le "v" à la fin de chaque table, laissant penser qu'il existe plusieurs versions de celles-ci.

==== Exemple d'appel en base de données ====
''SELECT out_id_type, out_nom_type, out_dirname_type, out_affichage, out_date_publication, out_date_modification, out_id_alias_auteur, out_id_groupe_auteur, out_ip, out_titre, out_texte, out_commentaire, out_visibilite, out_liaisons, out_tags, out_medias, out_version, out_fiche, out_jeu, out_data, out_url, out_id_jeux FROM jeu_get_v7 WHERE id_contenu = xxx''

=== Organisation technique ===

Comme dit précédemment, Respawn semble être un mélange de MVC et de code classique sans modèle particulier de respecté. Les fichiers du back-end sont également mitigés du côté de leur appellation, laissant encore droit au mélange entre Français et Anglais. Exemples de fichiers côté back-end :

''/opt/datas/JEUXVIDEO.COM/htdocs/forums/liste_topic.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/core/OiPDOStatement.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Transaction.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/GoogleTagManager.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Compte.php'' 
''/opt/datas/JEUXVIDEO.COM/app/controllers/forum/liste_topic.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Session.php'' 
''/opt/datas/JEUXVIDEO.COM/app/vendor/...''

=== Nommage des fonctions ===

Respawn possède aussi des fonctions dont le nommage est entre le Français et l'Anglais. Exemples de fonctions côté back-end :

''getInfoFromIdForum'' 
''loadMenu'' 
''checkMenuItem'' 
''getSingleton'' 
''getHtmlJeuForum'' 
''blocHtmlBoutiqueRandom''

=== Optimisations ===

Le back-end PHP utilise Memcache (https://www.php.net/manual/fr/book.memcache.php) afin de faire baisser la charge technique de l'applicatif.

=== Stockage des utilisateurs ===

Depuis Respawn, les utilisateurs de JVC sont référencés sous un identifiant numérique côté base de données, contrairement au fonctionnement de l'ancien JVC où les utilisateurs étaient référencés par leur pseudo (pouvant mener à des posts sur les forums avec des pseudos identiques organisés différemment côté minuscules/majuscules).

Il est possible d'obtenir son ID via la page permettant d'éditer votre profil, l'ID est à la fin de l'URL.

=== Les forums ===

Les posts des forums sont déclarés sur plusieurs serveurs différents. Les IDs de ceux-ci semblent aléatoires (bien qu'un offset était attribué pour les posts présents sur ForumJV). Les IDs sont choisis selon l'emplacement dans lequel la ressource sera stockée lors de la création du topic. Le choix de l'emplacement se fait à la création du topic, les messages dans le topic sont alors stockés dans le même emplacement. Il semblerait qu'il y ait 8 emplacements. ID + 8 pour accéder à la ressource suivante, et ID - 8 pour accéder à la ressource précédente.

Exemple de messages séquentiels:

* https://www.jeuxvideo.com/forums/message/905193382
* https://www.jeuxvideo.com/forums/message/905193390
* https://www.jeuxvideo.com/forums/message/905193398

L'ID est incrémenté de 8 à chaque fois. Tous ces messages sont répertoriés dans le 7ème serveur (<code>ID % 8</code>, donc <code>905193382 % 8 = 6</code>, 7ème).

À noter toutefois que les messages datant d'avant respawn sont complètement désordonnés, certainement dû à la migration durant respawn où la migration de ces messages a été effectué en parallèle.

=== Modération ===

La modération sur Respawn se nomme "Accès étendu". L'accès étendu peut être appelé via la page qui lui est dédiée : https://www.jeuxvideo.com/sso/auth.php ; il nécessite en revanche également un mot de passe, qui est envoyé via un lien sécurisé utilisable une seule fois par MP à chaque modérateur. A noter que le [[103]] est accessible à n'importe quel modérateur même sans authentification à l'accès étendu.

=== Authentification ===

Le cookie [[coniunctio]] est utilisé pour l'authentification.

=== Recherche des forums ===

La recherche des forums utilise le moteur de recherche Sphinx qui est intégré au site. La recherche des forums est limitée à 1 mois sur les blablas, elle peut être contournée via https://jvarchive.com/.

=== Sécurité informatique ===

Dans les débuts de Respawn, le site était rempli de failles permettant de faire exploser la charge du site. Il existait également de nombreuses failles sur [[ForumJV]] qui permettaient de modérer sans être modérateur, sur n'importe quel forum. Les failles ici citées ont en majorité été exploitées par [[edwado]].

Il a également existé une faille RCE (Remote Code Execution) exploitée par [[Tsain]], qui permettait d'injecter du CSS sur n'importe quelle partie du site (la faille fut très mal exploitée étant-donné que celle-ci n'était pas qu'une simple injection CSS mais bien une RCE où il était possible d'injecter un shell PHP).

=== JvCare ===

JvCare est un algorithme d'obfuscation des liens externes postés sur le site. Il a été développé depuis Respawn. Il permet d'éviter la création de backlinks qui pourraient optimiser indirectement le SEO de sites externes à Jeuxvideo.com.

Les codes ci-après permettent de décoder une chaîne obfusquée.

==== PHP ====

function jvCare(string $classe) : string {
static $base16 = "0A12B34C56D78E9F";
$lien = "";
$s = explode(" ", $classe)[1];
for ($i = 0; $i < strlen($s); $i += 2) {
$lien .= chr(strrpos($base16, $s[$i]) * 16 + strrpos($base16, $s[$i + 1]));
}
return $lien;
}

==== JavaScript ====

function jvCake(classe) {
const base16 = '0A12B34C56D78E9F';
let lien = <nowiki>''</nowiki>;
const s = classe.split(' ')[1];
for (let i = 0; i < s.length; i += 2) {
lien += String.fromCharCode(base16.indexOf(s.at(i)) * 16 + base16.indexOf(s.at(i + 1)));
}
return lien;
}

===== Fonctionnel =====

function jvCake(classe) {
const base16 = '0A12B34C56D78E9F';
const s = classe.split(' ')[1];
const codeUnits = s
.match(/../g)
.map((i) => base16.indexOf(i[0]) * 16 + base16.indexOf(i[1]));
return String.fromCharCode(...codeUnits);
}

==== Python ====

def jvcare(classe: str) -> str:
base16 = '0A12B34C56D78E9F'
s = classe.split()[1]
url = <nowiki>''</nowiki>
for i, j in zip(s[0::2], s[1::2]):
url += chr(base16.index(i) * 16 + base16.index(j))
return url

===== Liste en compréhension =====

def jvcare(classe: str) -> str:
base16 = '0A12B34C56D78E9F'
s = classe.split()[1]
return <nowiki>''</nowiki>.join([chr(base16.index(i) * 16 + base16.index(j)) for i, j in zip(s[0::2], s[1::2])])

==== C ====

#include <stdlib.h>
#include <string.h>

const char *__jvcarebase16 = "0A12B34C56D78E9F";

char *jvcare(const char *class) {
char *s = strchr(class, ' ') + 1;

int urllen = strlen(s) / 2;
char *url = malloc(urllen + 1);
for (int i = 0; i < urllen; i++) {
char pos1 = strchr(__jvcarebase16, s[i * 2]) - __jvcarebase16;
char pos2 = strchr(__jvcarebase16, s[i * 2 + 1]) - __jvcarebase16;
url[i] = pos1 * 16 + pos2;
}
url[urllen] = '\0';
return url;
}

==== Awk ====

BEGIN {
base16 = "0A12B34C56D78E9F"
}
{
s = $2
for (i = 1; i < length(s); i += 2) {
pos1 = index(base16, substr(s, i, 1))
pos2 = index(base16, substr(s, i + 1, 1))
url = url sprintf("%c", (pos1 - 1) * 16 + (pos2 - 1))
}
print url
}

== Phoenix ==

Phoenix était une partie de JVC développée en Node.js et utilisant React. De plus en plus abandonnée au fil du temps, elle était utilisée pour afficher la liste des jeux et des contenus de la rédaction. Phoenix utilisait une API spéciale hébergée au sous-domaine [[Documentation_de_l%27API_Jeuxvideo.com#API_jvc.gg|''api.jvc.gg'']]. Phoenix ainsi que l'API GG disparaissent en février 2025 et les pages qu'elles servaient sont basculées vers la partie principale du site.

== Liens externes ==

* [http://www.journaldunet.com/solutions/itws/050426_it_jeuxvideo.shtml Interview sur l’architecture de jeuxvideo.com de 1997 à 2005] ([http://web.archive.org/web/20070629165914/http://www.journaldunet.com/solutions/itws/050426_it_jeuxvideo.shtml archive.org])

== Notes ==

<references />

== Voir aussi ==

* [[Documentation de l'API Jeuxvideo.com]]

{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Documentation de l'API Jeuxvideo.com

2025-03-01T11:04:19Z

HelloWorld5000 : /* JVClient */ typo

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=JVClient=
[[File:icon-512x512.png|vignette|256px|Le logo de JVClient : « Le pouvoir par les données ».]]

[https://www.npmjs.com/package/jv-client '''JVClient'''] est une '''librairie Node.js''' écrite en TypeScript qui fournit des classes et des fonctions permettant d'interagir avec l'API v4 de jeuxvideo.com ainsi que le site JVC lui-même.
Publiée en février 2025, son objectif est de servir de base aux programmeurs pour le ''scraping'' de données sur des jeux, articles, forums, topics, etc. et pour l'exécution d'opérations nécessitant un compte connecté (comme poster des topics). Le code est ''open source'' et disponible sur Github<ref>https://github.com/Contrapunctus-XIV/jv-client</ref>.

Elle dispose également d'une documentation complète<ref>https://contrapunctus-xiv.github.io/jv-client/</ref> qui explique en détail l'organisation des données de jeuxvideo.com.

{{clear}}

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine pour les forums ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable site Web, qui réplique les forums du site www.jeuxvideo.com : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>. Il manque cependant de nombreuses fonctionnalités comme les pages de profils sur le sous-domaine API.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints de service==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).
On rappelle que l'accès à ces ''endpoints'' nécessite un token d'authentification à fournir dans le header ''Jvc-Authorization''. Voir l'[[#annexe|annexe]] pour le générer.

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}

[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API était une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle était hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

L'API est fermée début février 2025 à la suite de la refonte des pages Phoenix de JVC qui adoptent désormais le même fonctionnement que les autres pages du site.

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Documentation de l'API Jeuxvideo.com

2025-03-01T11:03:48Z

HelloWorld5000 : JVClient, dépréciation de l'api GG, corrections sur v4, retrait bannière

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=JVClient=
[[File:icon-512x512.png|vignette|256px|Le logo de JVClient : « Le pouvoir par les données ».]]

[https://www.npmjs.com/package/jv-client '''JVClient'''] est une '''librairie Node.js''' écrite en TypeScript qui fournit des classes et des fonctions permettant d'interagir avec l'API v4 de jeuxvideo.com ainsi que le site JVC lui-même.
Publiée en février 2025, son objectif est de servir de base aux programmeurs pour le ''scraping'' de données sur des jeux, articles, forums, topics, etc. et pour l'exécution d'opérations nécessitant un compte connecté (comme poster des topics). Le code est ''open source'' et disponiblesur Github<ref>https://github.com/Contrapunctus-XIV/jv-client</ref>.

Elle dispose également d'une documentation complète<ref>https://contrapunctus-xiv.github.io/jv-client/</ref> qui explique en détail l'organisation des données de jeuxvideo.com.

{{clear}}

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine pour les forums ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable site Web, qui réplique les forums du site www.jeuxvideo.com : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>. Il manque cependant de nombreuses fonctionnalités comme les pages de profils sur le sous-domaine API.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints de service==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).
On rappelle que l'accès à ces ''endpoints'' nécessite un token d'authentification à fournir dans le header ''Jvc-Authorization''. Voir l'[[#annexe|annexe]] pour le générer.

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}

[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API était une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle était hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

L'API est fermée début février 2025 à la suite de la refonte des pages Phoenix de JVC qui adoptent désormais le même fonctionnement que les autres pages du site.

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Fichier:icon-512x512.png

2025-03-01T10:51:01Z

HelloWorld5000 : Fichier téléversé avec MsUpload

Fichier téléversé avec MsUpload

Documentation de l'API Jeuxvideo.com

2025-02-08T10:57:45Z

HelloWorld5000 : /* Queries des tests */ Correction lien pastebin

{{Bannière Info|Contenu=Co-rédacteur de cet article, j'aurais besoin de l'aide d'un khey calé sur l'API de JVC et/ou le fonctionnement technique de jeuxvideo.com. J'ai plusieurs questions à poser en vue de la réalisation d'un projet informatique. (Edwado si tu passes par là…) 

Merci de me contacter sur JVC (pseudo ContrapunctusI{{CDV|Pseudo=ContrapunctusI}}). Toute aide sera appréciée.}}

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/YxKif1DJ ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Histoire du Blabla 18-25 ans en 2024

2024-10-27T11:50:11Z

HelloWorld5000 : /* Faits Marquants */

{{Bannière Note|Contenu=L'enrichissement de cette page dépend entièrement du bon vouloir des forumeurs. Si vous êtes témoin d'un évènement notable, n'hésitez pas à l'inclure ici car il est probable que personne d'autre ne le fera, le faisant ainsi sombrer dans l'oubli {{triste}}}}Cet article présente '''l'histoire détaillée''' du '''forum [[Blabla 18-25 ans]]''' durant l'année '''2024'''.

Pour consulter les articles des autres années voir la section [[Blabla 18-25 ans#Histoire%20du%20forum|Histoire du forum]] de la page principale.

== Histoire du forum en 2024 ==
L'année est inaugurée par le traditionnel [[PEMT du Nouvel An 2024|PEMT du nouvel an]] qui enregistre 85 réussites pour environ 330 posts entre 23:57 et 00:03 ; ces chiffres sont en baisse par rapport à ceux de l'[[PEMT du Nouvel An 2023|édition précédente]].

Toujours aucun délire notable en vue. La [[Modération du 18-25|modération dictatoriale]] et la boucle ayant à tout jamais anéanti le forum, qui ne voit que 800 connectés les samedis soir, contre 5000 au plus haut du forum en 2016.

== Faits Marquants ==
{{Bannière Note|Contenu=Avant de rajouter une entrée veillez bien à lire et comprendre la bannière bleue ci-après. '''Un topic anodin de 10 pages n'a rien à faire ici.''' Le principe de cet article est de documenter les faits marquants et méritant de figurer dans l'histoire éternelle du forum. Il n'a pas vocation à archiver le moindre topic rouge comme si il était décisif dans l'histoire de la communauté.}}{{Bannière Info|Contenu='''Évènements notables''' : Nouveau délire, un topic légendaire, un raid important, un phénomène relatif au forum, un nouveau sujet de discussion relatif au forum très populaire et faisant couler de nombreux topics sur plusieurs jours. 
'''Évènements non-notables''' : Un topic qui ne sort pas du lot, un phénomène passé inaperçu (quelques topics), une actualité qui ne concerne pas le forum même si très discutée sur celui-ci.
[[Special:Diff/153117/prev|Exemple d'évènements non-notables qui ont été retirés de la page.]]}}
* '''Le 1 janvier :''' Après son défi de se prendre en photo pendant toute l'année 2022, ''Shakclash27'' {{CDV|Shakclash27}} a décidé de remettre le couvert en se prenant en photo pendant toute l'année 2024 dans son [[topic]] [https://www.jeuxvideo.com/forums/42-51-73577798-1-0-1-0-je-me-prends-en-photo-pendant-toute-l-annee.htm "je me prends en photo pendant toute l'année"].
* '''Le 19 février :''' Le topic sur le jeu en ligne [[Clan 1825 de Territorial.io|Territorial.io]]<ref>https://www.jeuxvideo.com/forums/42-51-73828201-1-0-1-0-raid-sur-territorial-io-la-saison-2-commence.htm</ref> reprend en activité, arrivant même a faire passer le clan 1825 4éme, et 1 an après la création du 1er topic, une [[Clan 1825 de Territorial.io|"Saison 2" est lancée]]

* '''Fin février''' ''':''' Le forumeur ''LeBossLelite'' et d'autres forumeurs [[Spam|spammen]][[Spam|t]] tous les jours le délire [[Mets ma viande dans ta bouche]]<ref>https://jvarchive.com/forums/42-51-73863346-1-0-1-0-ce-gros-texan-deter-a-bench-met-la-dans-ta-bouche-met-toute-ma-viande-dans-ta-bouche</ref>.[[Fichier:doumbépied.png|vignette|201x201px|Sticker ironisant sur le combat et le discours de Cédric Doumbé]]
* '''Le 7 mars :''' Lors du combat de MMA entre Baysangur Chamsoudinov et Cédric Doumbé<ref>https://jvarchive.com/forums/42-51-73910111-1-0-1-0-officiel-pfl-paris-doumbe-vs-baki</ref> , le forum connaît un regain d'activité exceptionnel durant la soirée , atteignant même +2900 connectées<ref>https://jvarchive.com/forums/42-51-73883036-1-0-1-0-attendez-y-a-vraiment-2845-connectes</ref>. De nombreux topics<ref>https://jvarchive.com/forums/42-51-73913801-1-0-1-0-serieux-pourquoi-doumbe-se-plaignait-de-cette-putain-d-echarde</ref> et stickers seront fait à propos de l'abandon du combattant Cédric Doumbé suite à une écharde qui se trouvera dans son doigt de pied, ce dernier ayant eu une campagne de promotion médiatique du combat très agressive et beaucoup ironisant sur le fait que c'est donc lui qui a abandonné le combat.
* '''Mars :''' La boucle sur le délire des "[[Burgers a 50 centimes|'''Burgers a 50 centimes''']]" est très active.<ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=burger&page=2</ref>
* '''Le 20 mars :''' Le forum célèbre la naissance de [[Bébé Prout|'''Baby Prout''']]. Véritable prophète pour certains.
* '''Le 25 mars :''' Le foromeur ''McRacheley'' {{CDV|Pseudo=mcracheley}} crée un topic intitulé « [https://www.jeuxvideo.com/forums/42-51-74041719-1-0-1-0-j-ai-demande-a-l-ia-de-me-faire-une-bd-asterix.htm J'ai demandé à l'IA de me faire une BD ASTERIX] », le résultat provoquant un vague de fou rire chez les [[Khey|kheys]] présents ce soir là, en effet, les personnages d’Astérix dessinés par l’IA le sont de manière particulièrement maladroite. L’expression « SAALIAX » utilisé par l’un des personnages deviendra le leitmotiv de ce nouveau délire, ainsi que la boisson aux effets hallucinogènes consommée par nos deux gaulois, la « spiphue ». Au fur et à mesure des jours suivants de nombreux forumeurs créeront à leur tour des variantes de ces BD, parfois en faisant référence à d’autres délires.
* '''Le 28 mars''' : Un article du Monde indique qu'un certain "Carl C." était à l'origine de fausses alertes à la bombe dans des établissements scolaires la semaine précédente<ref>https://www.lemonde.fr/societe/article/2024/03/28/derriere-les-menaces-d-attentats-a-l-encontre-des-ecoles-des-piratages-et-de-mauvais-canulars_6224714_3224.html#</ref>. Un tweet indique que cet individu, à défaut d'être un islamiste, serait un khey "plutôt islamophobe"<ref>https://twitter.com/Tajmaat_Service/status/1773462628582518860?t=7SqCIaUShjWYM4oVAchkDw</ref>. La nouvelle fait l'objet d'un topic sur le forum<ref>https://jvarchive.com/forums/42-51-74012694-1-0-1-0-alerte-un-khey-est-derriere-les-fausses-alertes-a-la-bombe</ref>.
* '''Le 8 avril''' : Le forum est en effervescence face à de nombreux éléments, ressemblant notamment au délire [[Pour rappel en 2022]]. En effet, ce 8 avril a lieu une éclipse solaire, la comète du diable est visible et le CERN doit activer un accélérateur de particules, qui selon le forum détruira l'univers ou nous projetteras dans une nouvelle dimension<ref>https://www.jeuxvideo.com/forums/42-51-74078349-1-0-1-0-le-cern-debute-son-experience-dans-27-minutes.htm</ref>.
* '''Le 20 avril :''' Une vague de DDoS répétés visant les sites complémentaires à jeuxvideo.com débute. Risibank est attaqué en premier<ref>https://www.jeuxvideo.com/forums/42-51-74125630-1-0-1-0-ff892t.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-74152467-1-0-1-0-m5qggk.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-74125630-1-0-1-0-b646ia.htm</ref>. L'attaque serait consécutive à la publication d'une photo gore sur ce dernier<ref>[https://jvarchive.com/forums/42-51-74128369-1-0-1-0-ayaaa-le-sticker-tendance-sur-risibank https://jeuxvideo.com/forums/42-51-74128369-1-0-1-0-ayaaa-le-sticker-tendance-sur-risibank]</ref>.
* '''Le 21 avril :''' [[JVFlux]] est également affecté par le DDoS<ref>https://www.jeuxvideo.com/forums/42-51-74135865-1-0-1-0-04w8yu.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-74155259-1-0-1-0-ya0lx6.htm</ref>.
* '''Le 24 avril :''' Le 24 avril, un jeu vidéo FPS sort avec de nombreux délires relatifs au forum, il s'appelle [https://www.risifield.fr/ RISIFIELD.]<ref>https://www.jeuxvideo.com/forums/42-51-74163816-1-0-1-0-risifield-le-premier-fps-multijoueur-dedie-au-forom.htm</ref>
* '''Le 29 avril :''' Un bug du site laisse tous les topics [[Erreur 410|410]] en première page, rendant les forums de jeuxvideo.com inutilisables. Certains forumeurs se réfugient sur un topic bunker<ref>https://www.jeuxvideo.com/forums/42-51-74187928-1-0-1-0-bunker-anti-bug-jvc.htm</ref> tandis qu'une cinquantaine se dirigent vers [[Onche.org]]<ref>https://onche.org/topic/515547/si-le-forom-etait-un-c-c-de-jvc-tout-le-monde-serait-ici/1</ref><ref>https://onche.org/topic/515464/les-kheys-de-jvc-n-oubliez-pas-que-vous-serez-toujours/1</ref>.
*'''Le 6 mai :''' Un [[Topic]] sur lequel l'auteur poste une photo d'[[Asterion]] adossé à un mur et entouré de déchets est créé. S'en suivra alors une réaction de grands nombre de défenseurs de Kirby s'opposant à ses ''haters''. À l'heure actuelle, le topic atteint 14 pages<ref>https://jvarchive.com/forums/42-51-74230435-1-0-1-0-photo-kirby-est-complement-brisax-il-est-finito</ref>. Le topic est supprimé le jour suivant<ref>https://www.jeuxvideo.com/forums/42-51-74230435-1-0-1-0-photo-kirby-est-complement-brisax-il-est-finito.htm</ref>
*[[Fichier:Admins Webedia Streamable.png|vignette|Mail de Webedia expliquant la raison de l'interdiction des sites d'hébergement vidéo |259x259px]]'''Le 28 mai :''' [[Webedia]] prend la décision d'interdire tous les liens menant vers des sites d'hébergement vidéo comme Streamable ou Webmshare. Selon eux, cette décision a été prise car beaucoup de ces liens menaient vers des vidéos allaient contre la charte des forums et que ça saturait la bande passante du site<ref>https://www.jeuxvideo.com/forums/42-51-74327261-12-0-1-0-censure-les-videos-streamable-desormais-auto-supprimee-sur-le-forom.htm</ref>. Pourtant, plusieurs heures plus tard, Webedia revient sur cette décision, ne filtrant que les liens de vidéos spécifiques.
*'''Le 2 juin :''' Le journal "Le Monde" révèle que le candidat du Rassemblement National, [[Jordan Bardella]] avait eu sur jeuxvideo.com plusieurs pseudos dont "Mrjordan9320" et "el_italiano93" suscitant de nombreux topics et réaction. A l'heure actuelle, le topic a dépassé 180 pages<ref>https://www.jeuxvideo.com/forums/42-51-74340201-1-0-1-0-le-monde-bardella-trainait-sur-les-forums-jvc-au-college.htm</ref>.
*'''Le 8 juin :''' Après plusieurs topics de boucle sur une youtubeuse de niche, le forum finit par attirer son attention lors d'un topic<ref>https://jvarchive.com/forums/42-51-74340156-9-0-1-0-alerte-2-kheys-ont-succombe-a-ses-charmes</ref>, pour l'occasion le khey ''Kheyoken'' {{CDV|Pseudo=kheyoken}} s'illustrera en simperie en lui faisant don de 30 euros<ref>https://image.noelshack.com/fichiers/2024/23/6/1717874825-image.png</ref>. ''Annieyonki04'' {{CDV|Pseudo=annieyonki04}} arrivera par la même occasion a séduire la belle teen<ref>https://image.noelshack.com/fichiers/2024/23/6/1717879551-image.png</ref> grâce a un poème<ref>[[:Fichier:chanson-cylene.mp4]]</ref>.
*'''Le 10 juin :''' L'enseigne Lidl lance un jeu concours avec une IA nommée "[https://lidlize.com/ Lidlize]" où les 3 gagnants qui auront proposé des concepts générés par IA gagneront 1 an de courses. Très rapidement, de nombreux forumeurs s'amusent avec des concepts faisant référence aux délires du forum<ref>https://jvarchive.com/forums/42-51-74370210-1-0-1-0-alerte-via-un-concours-lidl-offre-la-possibilite-de-creer-notre-propre-produit</ref>. Cependant la censure s'abat contre leur création et se faisant retirer très rapidement, soupçonnant même des infiltrés de Lidl sur le topic.[[Ahi|ahi sauvage]]

* '''Le 17 août :''' De nombreux forumeurs reprennent la délire [[Tête de ouf|fatigué (tête de ouf)]], originaire d'Onche. Tout part d'un live TikTok entre AD Laurent et un utilisateur utilisant le pseudo Pablo27200. La réaction décontenancée d'AD Laurent face à une cinquantenaire à l'apparence très affaissée et la réponse nonchalante de ce dernier (''"j'suis fatigué, frère"'') amuseront grandement certains forumeurs. Plus tard, un autre échange sur le même mode, repris par le khey ''Chocoyaa'' {{CDV|Pseudo=chocoyaa}} dans lequel une [[French Dream|dreameuse]] essayera de séduire AD Laurent<ref>https://streamable.com/u4ruh4</ref> tout en se montrant difficile et coquette rencontrera un succès moindre.

* '''Le 10 octobre :''' Des liens d'une conférence de presse confidentielle du ministère de l'Agriculture, dévoilant son projet de finances, ont fuité sur le forum<ref>https://jvarchive.com/forums/42-51-74969526-1-0-1-0-ayaaaaaaa-reunion-zoom-avec-la-ministre-de-l-agriculture-no-fake</ref><ref>https://jvarchive.com/forums/42-51-74945460-1-0-1-0-ayaaaaaaa-reunion-zoom-avec-la-ministre-de-l-agriculture-no-fake</ref>. Le [[raid]] a rapidement pris fin grâce à un dénonciateur qui a signalé la fuite dans le chat de la conférence. Malgré cela, des questions sur la conservation de l[[Ahi|'ahi sauvage]] et le "Plan Chancla 2025" ont été posées aux membres du gouvernement. Un "Ta gueule" très audible a également retenti dans la salle de conférence Webex. Le Parisien a publié un article le soir même relatant les faits<ref>https://www.leparisien.fr/politique/ca-ressemblait-a-des-interventions-dadolescents-une-audioconference-du-ministere-de-lagriculture-perturbee-11-10-2024-NO2IRIMF3RDPRBBJLBBWQRE22Q.php | [https://archive.is/js8BJ <nowiki>[archive.is]</nowiki>]</ref>. Le ministère de l'Agriculture commentera le raid en observant que ''« Ça ressemblait à des interventions d’adolescents ».''

* '''Le 27 octobre :''' De nombreux forumeurs se plaignent de rencontrer des lags à cause des serveurs de JVC. Aux alentours de 12 h 45, le site est quasiment inaccessible, renvoyant des erreurs 503 à chaque requte.

==Références==

[[Catégorie:Blabla 18-25 ans]]
[[Catégorie:Histoire du forum Blabla 18-25 ans]]
<references />

Histoire du Blabla 18-25 ans en 2024

2024-10-27T11:48:56Z

HelloWorld5000 :

{{Bannière Note|Contenu=L'enrichissement de cette page dépend entièrement du bon vouloir des forumeurs. Si vous êtes témoin d'un évènement notable, n'hésitez pas à l'inclure ici car il est probable que personne d'autre ne le fera, le faisant ainsi sombrer dans l'oubli {{triste}}}}Cet article présente '''l'histoire détaillée''' du '''forum [[Blabla 18-25 ans]]''' durant l'année '''2024'''.

Pour consulter les articles des autres années voir la section [[Blabla 18-25 ans#Histoire%20du%20forum|Histoire du forum]] de la page principale.

== Histoire du forum en 2024 ==
L'année est inaugurée par le traditionnel [[PEMT du Nouvel An 2024|PEMT du nouvel an]] qui enregistre 85 réussites pour environ 330 posts entre 23:57 et 00:03 ; ces chiffres sont en baisse par rapport à ceux de l'[[PEMT du Nouvel An 2023|édition précédente]].

Toujours aucun délire notable en vue. La [[Modération du 18-25|modération dictatoriale]] et la boucle ayant à tout jamais anéanti le forum, qui ne voit que 800 connectés les samedis soir, contre 5000 au plus haut du forum en 2016.

== Faits Marquants ==
{{Bannière Note|Contenu=Avant de rajouter une entrée veillez bien à lire et comprendre la bannière bleue ci-après. '''Un topic anodin de 10 pages n'a rien à faire ici.''' Le principe de cet article est de documenter les faits marquants et méritant de figurer dans l'histoire éternelle du forum. Il n'a pas vocation à archiver le moindre topic rouge comme si il était décisif dans l'histoire de la communauté.}}{{Bannière Info|Contenu='''Évènements notables''' : Nouveau délire, un topic légendaire, un raid important, un phénomène relatif au forum, un nouveau sujet de discussion relatif au forum très populaire et faisant couler de nombreux topics sur plusieurs jours. 
'''Évènements non-notables''' : Un topic qui ne sort pas du lot, un phénomène passé inaperçu (quelques topics), une actualité qui ne concerne pas le forum même si très discutée sur celui-ci.
[[Special:Diff/153117/prev|Exemple d'évènements non-notables qui ont été retirés de la page.]]}}
* '''Le 1 janvier :''' Après son défi de se prendre en photo pendant toute l'année 2022, ''Shakclash27'' {{CDV|Shakclash27}} a décidé de remettre le couvert en se prenant en photo pendant toute l'année 2024 dans son [[topic]] [https://www.jeuxvideo.com/forums/42-51-73577798-1-0-1-0-je-me-prends-en-photo-pendant-toute-l-annee.htm "je me prends en photo pendant toute l'année"].
* '''Le 19 février :''' Le topic sur le jeu en ligne [[Clan 1825 de Territorial.io|Territorial.io]]<ref>https://www.jeuxvideo.com/forums/42-51-73828201-1-0-1-0-raid-sur-territorial-io-la-saison-2-commence.htm</ref> reprend en activité, arrivant même a faire passer le clan 1825 4éme, et 1 an après la création du 1er topic, une [[Clan 1825 de Territorial.io|"Saison 2" est lancée]]

* '''Fin février''' ''':''' Le forumeur ''LeBossLelite'' et d'autres forumeurs [[Spam|spammen]][[Spam|t]] tous les jours le délire [[Mets ma viande dans ta bouche]]<ref>https://jvarchive.com/forums/42-51-73863346-1-0-1-0-ce-gros-texan-deter-a-bench-met-la-dans-ta-bouche-met-toute-ma-viande-dans-ta-bouche</ref>.[[Fichier:doumbépied.png|vignette|201x201px|Sticker ironisant sur le combat et le discours de Cédric Doumbé]]
* '''Le 7 mars :''' Lors du combat de MMA entre Baysangur Chamsoudinov et Cédric Doumbé<ref>https://jvarchive.com/forums/42-51-73910111-1-0-1-0-officiel-pfl-paris-doumbe-vs-baki</ref> , le forum connaît un regain d'activité exceptionnel durant la soirée , atteignant même +2900 connectées<ref>https://jvarchive.com/forums/42-51-73883036-1-0-1-0-attendez-y-a-vraiment-2845-connectes</ref>. De nombreux topics<ref>https://jvarchive.com/forums/42-51-73913801-1-0-1-0-serieux-pourquoi-doumbe-se-plaignait-de-cette-putain-d-echarde</ref> et stickers seront fait à propos de l'abandon du combattant Cédric Doumbé suite à une écharde qui se trouvera dans son doigt de pied, ce dernier ayant eu une campagne de promotion médiatique du combat très agressive et beaucoup ironisant sur le fait que c'est donc lui qui a abandonné le combat.
* '''Mars :''' La boucle sur le délire des "[[Burgers a 50 centimes|'''Burgers a 50 centimes''']]" est très active.<ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=burger&page=2</ref>
* '''Le 20 mars :''' Le forum célèbre la naissance de [[Bébé Prout|'''Baby Prout''']]. Véritable prophète pour certains.
* '''Le 25 mars :''' Le foromeur ''McRacheley'' {{CDV|Pseudo=mcracheley}} crée un topic intitulé « [https://www.jeuxvideo.com/forums/42-51-74041719-1-0-1-0-j-ai-demande-a-l-ia-de-me-faire-une-bd-asterix.htm J'ai demandé à l'IA de me faire une BD ASTERIX] », le résultat provoquant un vague de fou rire chez les [[Khey|kheys]] présents ce soir là, en effet, les personnages d’Astérix dessinés par l’IA le sont de manière particulièrement maladroite. L’expression « SAALIAX » utilisé par l’un des personnages deviendra le leitmotiv de ce nouveau délire, ainsi que la boisson aux effets hallucinogènes consommée par nos deux gaulois, la « spiphue ». Au fur et à mesure des jours suivants de nombreux forumeurs créeront à leur tour des variantes de ces BD, parfois en faisant référence à d’autres délires.
* '''Le 28 mars''' : Un article du Monde indique qu'un certain "Carl C." était à l'origine de fausses alertes à la bombe dans des établissements scolaires la semaine précédente<ref>https://www.lemonde.fr/societe/article/2024/03/28/derriere-les-menaces-d-attentats-a-l-encontre-des-ecoles-des-piratages-et-de-mauvais-canulars_6224714_3224.html#</ref>. Un tweet indique que cet individu, à défaut d'être un islamiste, serait un khey "plutôt islamophobe"<ref>https://twitter.com/Tajmaat_Service/status/1773462628582518860?t=7SqCIaUShjWYM4oVAchkDw</ref>. La nouvelle fait l'objet d'un topic sur le forum<ref>https://jvarchive.com/forums/42-51-74012694-1-0-1-0-alerte-un-khey-est-derriere-les-fausses-alertes-a-la-bombe</ref>.
* '''Le 8 avril''' : Le forum est en effervescence face à de nombreux éléments, ressemblant notamment au délire [[Pour rappel en 2022]]. En effet, ce 8 avril a lieu une éclipse solaire, la comète du diable est visible et le CERN doit activer un accélérateur de particules, qui selon le forum détruira l'univers ou nous projetteras dans une nouvelle dimension<ref>https://www.jeuxvideo.com/forums/42-51-74078349-1-0-1-0-le-cern-debute-son-experience-dans-27-minutes.htm</ref>.
* '''Le 20 avril :''' Une vague de DDoS répétés visant les sites complémentaires à jeuxvideo.com débute. Risibank est attaqué en premier<ref>https://www.jeuxvideo.com/forums/42-51-74125630-1-0-1-0-ff892t.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-74152467-1-0-1-0-m5qggk.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-74125630-1-0-1-0-b646ia.htm</ref>. L'attaque serait consécutive à la publication d'une photo gore sur ce dernier<ref>[https://jvarchive.com/forums/42-51-74128369-1-0-1-0-ayaaa-le-sticker-tendance-sur-risibank https://jeuxvideo.com/forums/42-51-74128369-1-0-1-0-ayaaa-le-sticker-tendance-sur-risibank]</ref>.
* '''Le 21 avril :''' [[JVFlux]] est également affecté par le DDoS<ref>https://www.jeuxvideo.com/forums/42-51-74135865-1-0-1-0-04w8yu.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-74155259-1-0-1-0-ya0lx6.htm</ref>.
* '''Le 24 avril :''' Le 24 avril, un jeu vidéo FPS sort avec de nombreux délires relatifs au forum, il s'appelle [https://www.risifield.fr/ RISIFIELD.]<ref>https://www.jeuxvideo.com/forums/42-51-74163816-1-0-1-0-risifield-le-premier-fps-multijoueur-dedie-au-forom.htm</ref>
* '''Le 29 avril :''' Un bug du site laisse tous les topics [[Erreur 410|410]] en première page, rendant les forums de jeuxvideo.com inutilisables. Certains forumeurs se réfugient sur un topic bunker<ref>https://www.jeuxvideo.com/forums/42-51-74187928-1-0-1-0-bunker-anti-bug-jvc.htm</ref> tandis qu'une cinquantaine se dirigent vers [[Onche.org]]<ref>https://onche.org/topic/515547/si-le-forom-etait-un-c-c-de-jvc-tout-le-monde-serait-ici/1</ref><ref>https://onche.org/topic/515464/les-kheys-de-jvc-n-oubliez-pas-que-vous-serez-toujours/1</ref>.
*'''Le 6 mai :''' Un [[Topic]] sur lequel l'auteur poste une photo d'[[Asterion]] adossé à un mur et entouré de déchets est créé. S'en suivra alors une réaction de grands nombre de défenseurs de Kirby s'opposant à ses ''haters''. À l'heure actuelle, le topic atteint 14 pages<ref>https://jvarchive.com/forums/42-51-74230435-1-0-1-0-photo-kirby-est-complement-brisax-il-est-finito</ref>. Le topic est supprimé le jour suivant<ref>https://www.jeuxvideo.com/forums/42-51-74230435-1-0-1-0-photo-kirby-est-complement-brisax-il-est-finito.htm</ref>
*[[Fichier:Admins Webedia Streamable.png|vignette|Mail de Webedia expliquant la raison de l'interdiction des sites d'hébergement vidéo |259x259px]]'''Le 28 mai :''' [[Webedia]] prend la décision d'interdire tous les liens menant vers des sites d'hébergement vidéo comme Streamable ou Webmshare. Selon eux, cette décision a été prise car beaucoup de ces liens menaient vers des vidéos allaient contre la charte des forums et que ça saturait la bande passante du site<ref>https://www.jeuxvideo.com/forums/42-51-74327261-12-0-1-0-censure-les-videos-streamable-desormais-auto-supprimee-sur-le-forom.htm</ref>. Pourtant, plusieurs heures plus tard, Webedia revient sur cette décision, ne filtrant que les liens de vidéos spécifiques.
*'''Le 2 juin :''' Le journal "Le Monde" révèle que le candidat du Rassemblement National, [[Jordan Bardella]] avait eu sur jeuxvideo.com plusieurs pseudos dont "Mrjordan9320" et "el_italiano93" suscitant de nombreux topics et réaction. A l'heure actuelle, le topic a dépassé 180 pages<ref>https://www.jeuxvideo.com/forums/42-51-74340201-1-0-1-0-le-monde-bardella-trainait-sur-les-forums-jvc-au-college.htm</ref>.
*'''Le 8 juin :''' Après plusieurs topics de boucle sur une youtubeuse de niche, le forum finit par attirer son attention lors d'un topic<ref>https://jvarchive.com/forums/42-51-74340156-9-0-1-0-alerte-2-kheys-ont-succombe-a-ses-charmes</ref>, pour l'occasion le khey ''Kheyoken'' {{CDV|Pseudo=kheyoken}} s'illustrera en simperie en lui faisant don de 30 euros<ref>https://image.noelshack.com/fichiers/2024/23/6/1717874825-image.png</ref>. ''Annieyonki04'' {{CDV|Pseudo=annieyonki04}} arrivera par la même occasion a séduire la belle teen<ref>https://image.noelshack.com/fichiers/2024/23/6/1717879551-image.png</ref> grâce a un poème<ref>[[:Fichier:chanson-cylene.mp4]]</ref>.
*'''Le 10 juin :''' L'enseigne Lidl lance un jeu concours avec une IA nommée "[https://lidlize.com/ Lidlize]" où les 3 gagnants qui auront proposé des concepts générés par IA gagneront 1 an de courses. Très rapidement, de nombreux forumeurs s'amusent avec des concepts faisant référence aux délires du forum<ref>https://jvarchive.com/forums/42-51-74370210-1-0-1-0-alerte-via-un-concours-lidl-offre-la-possibilite-de-creer-notre-propre-produit</ref>. Cependant la censure s'abat contre leur création et se faisant retirer très rapidement, soupçonnant même des infiltrés de Lidl sur le topic.[[Ahi|ahi sauvage]]

* '''Le 17 août :''' De nombreux forumeurs reprennent la délire [[Tête de ouf|fatigué (tête de ouf)]], originaire d'Onche. Tout part d'un live TikTok entre AD Laurent et un utilisateur utilisant le pseudo Pablo27200. La réaction décontenancée d'AD Laurent face à une cinquantenaire à l'apparence très affaissée et la réponse nonchalante de ce dernier (''"j'suis fatigué, frère"'') amuseront grandement certains forumeurs. Plus tard, un autre échange sur le même mode, repris par le khey ''Chocoyaa'' {{CDV|Pseudo=chocoyaa}} dans lequel une [[French Dream|dreameuse]] essayera de séduire AD Laurent<ref>https://streamable.com/u4ruh4</ref> tout en se montrant difficile et coquette rencontrera un succès moindre.

* '''Le 10 octobre :''' Des liens d'une conférence de presse confidentielle du ministère de l'Agriculture, dévoilant son projet de finances, ont fuité sur le forum<ref>https://jvarchive.com/forums/42-51-74969526-1-0-1-0-ayaaaaaaa-reunion-zoom-avec-la-ministre-de-l-agriculture-no-fake</ref><ref>https://jvarchive.com/forums/42-51-74945460-1-0-1-0-ayaaaaaaa-reunion-zoom-avec-la-ministre-de-l-agriculture-no-fake</ref>. Le [[raid]] a rapidement pris fin grâce à un dénonciateur qui a signalé la fuite dans le chat de la conférence. Malgré cela, des questions sur la conservation de l[[Ahi|'ahi sauvage]] et le "Plan Chancla 2025" ont été posées aux membres du gouvernement. Un "Ta gueule" très audible a également retenti dans la salle de conférence Webex. Le Parisien a publié un article le soir même relatant les faits<ref>https://www.leparisien.fr/politique/ca-ressemblait-a-des-interventions-dadolescents-une-audioconference-du-ministere-de-lagriculture-perturbee-11-10-2024-NO2IRIMF3RDPRBBJLBBWQRE22Q.php | [https://archive.is/js8BJ <nowiki>[archive.is]</nowiki>]</ref>. Le ministère de l'Agriculture commentera le raid en observant que ''« Ça ressemblait à des interventions d’adolescents ».''

* '''Le 27 octobre :''' De nombreux forumeurs se plaignent de rencontrer des lags à cause des serveurs de JVC. Aux alentours de 12 h 45, le site est quasiment inaccessible, renvoyant des erreurs 503 à chaque requ.

==Références==

[[Catégorie:Blabla 18-25 ans]]
[[Catégorie:Histoire du forum Blabla 18-25 ans]]
<references />

Pavé Ma copine est morte en 2006

2024-10-18T16:12:57Z

HelloWorld5000 : /* Musical */ Ajout d'un vocaroo

'''''Ma copine est morte en 2006''''' est un [[pavé]] du [[forum]] [[Blabla 18-25 ans|18-25]] ans de [[jeuxvideo.com]]. Son utilisation répétée en fait une [[boucle]]. Il s'agit d'un pavé systématiquement supprimé par la modération depuis 2023<ref>https://jvarchive.com/topic/recherche?search=ma%20copine%20est%20morte%20en%202006&searchType=titre_topic</ref>. Le forumeur bouclant avec ce pavé a également utilisé les MP pour le diffuser<ref>https://jvarchive.com/forums/42-51-74567411-1-0-1-0-bordel-le-tare-qui-spamme-en-mp-sur-sa-copine-morte-en-2006</ref>.

== Le pavé ==

{{BoxPavé|Pavé=C'était ma première copine, celle qui m'a fait découvrir c'était quoi d'être aimé par un être vivant.
J'avais 13 ans a l'époque, j'étais au collège, elle était dans ma classe. J'étais heureux avec elle, on passait notre temps ensemble.

Un terrible jour de 2006, elle a eu un accident de voiture, fauchée par un chauffard de la pire espèce.
Depuis ce jour, je ne m'en suis jamais remis, ça m'a traumatisé, j'ai du voir un psy pendant des mois entiers.
J'ai sombré dans une terrible dépression, décrochage scolaire, puis déscolarisation.

Maintenant je touche l'AAH et je n'ai aucun avenir. Elle était tout pour moi, j'ai tout perdu, j'ai été incapable d'avoir de nouvelles copines par la suite. Encore aujourd'hui, je pleure en y pensant. J'ai gardé tout ce qu'on avait fait en commun dans une boite a trésor.}}

== Détournements Vocaroo ==

=== Musical ===

* https://vocaroo.com/13NUqStUswzf
* https://vocaroo.com/1oBGC6IDbw4Q

== Références ==
<references/>

{{Modèle:TableauCatégorieBoucle}}
[[Catégorie:Boucle du 18-25]]
[[Catégorie:Pavé]]

Discussion:Fonctionnement technique de Jeuxvideo.com

2024-09-24T21:04:14Z

HelloWorld5000 : /* Aide */

Bordel l'auteur comment a tu eu accès a autant d'info sur jvc . Tu travaille chez webedia ???????

== Aide ==

Co-rédacteur de l'[[API|article sur l'API de JVC]], j'aurais besoin de l'aide d'un khey calé sur l'API de JVC et/ou le fonctionnement technique de jeuxvideo.com. J'ai plusieurs questions à poser en vue de la réalisation d'un projet informatique. (Edwado si tu passes par là…)

Merci de me contacter sur JVC (pseudo '''ContrapunctusI'''). Toute aide sera appréciée.

Discussion:Fonctionnement technique de Jeuxvideo.com

2024-09-24T21:03:29Z

HelloWorld5000 : /* Aide */ nouvelle section

Bordel l'auteur comment a tu eu accès a autant d'info sur jvc . Tu travaille chez webedia ???????

== Aide ==

Co-rédacteur de cet article, j'aurais besoin de l'aide d'un khey calé sur l'API de JVC et/ou le fonctionnement technique de jeuxvideo.com. J'ai plusieurs questions à poser en vue de la réalisation d'un projet informatique. (Edwado si tu passes par là…)

Merci de me contacter sur JVC (pseudo '''ContrapunctusI'''). Toute aide sera appréciée.

Discussion:Documentation de l'API Jeuxvideo.com

2024-09-24T21:02:01Z

HelloWorld5000 : /* Aide */

Bonjour, déjà je tiens à remercier l'auteur de cet article pour la documentation très avancée à propos de l'API derrière l'application mobile.
Je voulais faire noter qu'il existe une autre API, en l'occurrence hébergée sur https://api.jvc.gg/ ; elle est utilisée par l'application web JV sur les pages Phoenix (exemple : https://www.jeuxvideo.com/tous-les-jeux/ ). Si des fois ça peut vous intéresser de la décortiquer, je pose ça là.

--[[Spécial:Contributions/2A02:842B:821A:1801:35A3:91A3:C52F:D0FC|2A02:842B:821A:1801:35A3:91A3:C52F:D0FC]] 17 mai 2024 à 14:05 (CEST)

Bonjour,

Merci beaucoup pour cette information. Je vais voir ce que je peux faire niveau rétro-ingénierie.

--[[Spécial:Contributions/HelloWorld5000|HelloWorld5000]] 17 mai 2024 à 20:14 (CEST)

Bonjour,

J'ai globalement compris comment fonctionnait cette API. Je documenterai la page JVFlux dans l'après-midi.
Connaîtrais-tu d'autres pages de JVC qui l'utilisent ? J'ai cru comprendre que la partie Phoenix du site se limitait aux jeux.

--[[Spécial:Contributions/HelloWorld5000|HelloWorld5000]] 18 mai 2024 à 09:33 (CEST)

== Aide ==

Co-rédacteur de cet article, j'aurais besoin de l'aide d'un khey calé sur l'API de JVC et/ou le fonctionnement technique de jeuxvideo.com. J'ai plusieurs questions à poser en vue de la réalisation d'un projet informatique. (Edwado si tu passes par là…)

Merci de me contacter sur JVC (pseudo '''ContrapunctusI'''). Toute aide sera appréciée.

Discussion:Documentation de l'API Jeuxvideo.com

2024-09-24T21:00:32Z

HelloWorld5000 : /* Aide */ nouvelle section

Bonjour, déjà je tiens à remercier l'auteur de cet article pour la documentation très avancée à propos de l'API derrière l'application mobile.
Je voulais faire noter qu'il existe une autre API, en l'occurrence hébergée sur https://api.jvc.gg/ ; elle est utilisée par l'application web JV sur les pages Phoenix (exemple : https://www.jeuxvideo.com/tous-les-jeux/ ). Si des fois ça peut vous intéresser de la décortiquer, je pose ça là.

--[[Spécial:Contributions/2A02:842B:821A:1801:35A3:91A3:C52F:D0FC|2A02:842B:821A:1801:35A3:91A3:C52F:D0FC]] 17 mai 2024 à 14:05 (CEST)

Bonjour,

Merci beaucoup pour cette information. Je vais voir ce que je peux faire niveau rétro-ingénierie.

--[[Spécial:Contributions/HelloWorld5000|HelloWorld5000]] 17 mai 2024 à 20:14 (CEST)

Bonjour,

J'ai globalement compris comment fonctionnait cette API. Je documenterai la page JVFlux dans l'après-midi.
Connaîtrais-tu d'autres pages de JVC qui l'utilisent ? J'ai cru comprendre que la partie Phoenix du site se limitait aux jeux.

--[[Spécial:Contributions/HelloWorld5000|HelloWorld5000]] 18 mai 2024 à 09:33 (CEST)

== Aide ==

Bonsoir,

J'aurais besoin de l'aide d'un khey calé sur l'API de JVC et/ou le fonctionnement technique de jeuxvideo.com. J'ai plusieurs questions à poser en vue de la réalisation d'un projet informatique.

Merci de me contacter sur JVC (pseudo '''ContrapunctusI'''). Toute aide sera appréciée.

Utilisateur:HelloWorld5000

2024-09-24T20:56:22Z

HelloWorld5000 :

Forumeur '''ContrapunctusI''', arrivé en septembre 2022 sur les forums.

{{ContactUtilisateur



|PseudoJVC= ContrapunctusI
}}

Documentation de l'API Jeuxvideo.com

2024-09-14T11:15:00Z

HelloWorld5000 : correction script auth_header + 3 nouveaux endpoints

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application. Une alternative "temporaire" consisterait à spawner des Android virtualisés, d'y installer de façon automatisée l'APK de JVC, puis de créer des comptes. Mais dans ce type de contexte, ce n'est plus vraiment de la rétro-ingiénierie.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|setFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|setFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|setFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
sorted_query = dict(sorted(query.items()))
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(sorted_query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Fonctionnement technique de Jeuxvideo.com

2024-09-12T07:13:07Z

HelloWorld5000 : API Phoenix

== Introduction ==
[[Jeuxvideo.com]] utilise 2 serveurs frontaux qui sont depuis le 7 mai 2022 protégés par le service [https://cloudflare.com Cloudflare]. Chaque serveur frontal utilise un serveur HTTP Apache, tout ce qu'il y a de plus classique. En revanche, avant d'arriver sur le serveur Apache, on a plusieurs mailles dans la chaîne. En effet, lorsque vous faites une requête auprès de JVC, la chaîne suivante est effectuée avant d'arriver jusqu'au back-end :
Cloudflare → Round-robin entre les 2 serveurs frontaux → HAProxy → Varnish → Apache → PHP / Express (Node.js)

== Processus d'une requête HTTP ==

'''Cloudflare''' est le premier point d'entrée pour accéder à JVC. Il gère les enregistrements DNS du site et ses IPs sont majoritairement aléatoires et anycastées/géocastées. Ce service touche la couche réseau/transport tout comme la couche applicative du modèle OSI : il fait office d'anti-DDoS à forte valeur (bien que JVC utilise le service "Volterra" en tant qu'anti-DDoS sur couches basses du côté des IPs de son AS 35717). Une partie de la couche applicative est protégée par Cloudflare, via des règles éditées manuellement par [[Webedia]] (entre autre, blocages de pools IPv4 de VPN connus, et de certains pays d'après certains retours d'utilisateurs).

Un round-robin est effectué via Cloudflare auprès des serveurs DNS de Webedia. Le but est de déterminer de façon algorithmique quel serveur frontal va être utilisé pour la requête HTTP.

'''HAProxy''' est un proxy et load-balancer TCP d'une efficacité remarquable, il est utilisé sur la totalité des environnements de production gérés par Webedia. C'est entre autre ce service à l'origine de l'erreur 403 Forbidden. En effet, HAProxy fait aussi office de protection applicative (on peut donc en déduire que JVC utilise plusieurs services sur couche haute pour protéger l'applicatif). On peut notamment remarquer le blacklistage des IPs du réseau "Tor", mais également le blacklistage des pools de l'AS 16276 (appartenant à la société OVH et n'étant utilisé que dans des contextes d'hébergement) - blocage mené suite à l'utilisation massive des services de la société OVH dans le but de scrapper/attaquer JVC.

'''Apache''' est un serveur HTTP. Il a été optimisé par l'équipe technique actuelle de Webedia, mais également par l'ancienne équipe du site (on peut notamment citer [[Dargor]] et [[Haazel]] en tant que personnes ayant participées à l'élaboration de tunning du serveur HTTP).

Le dernier point est selon la page qui est demandée. Des parties du site sont développées en PHP, et d'autres en Node.js. Pour l'anecdote, le site est hébergé côté serveur dans le dossier /opt/datas/sites/JEUXVIDEO.COM/<ref>La norme [https://fr.wikipedia.org/wiki/Filesystem_Hierarchy_Standard Filesystem Hierarchy Standard] n’incluait pas <code>/srv</code>, qui est plus approprié, avant 2004.</ref>. Il n'y a quasiment aucune protection de ce côté (si ce n'est une protection contre les IPs Tor).

=== Protection applicative Cloudflare ===

L'applicatif est donc, comme on a pu le voir, protégé par Cloudflare en premier point d'entrée. Cloudflare est binaire : si l'IP source est blacklistée, une HTTP 403 est retournée et l'accès à l'URI est refusé. Le blocage est en outre simple à bypasser, pour le moment, on peut constater que l'usage d'IPs géolocalisées en France est un bon bypass.

=== Domaine de fichiers statiques ===

'''static.jvc.gg''' est notamment utilisé pour servir les feuilles de styles et scripts et utilise comme serveur '''nginx''' au lieu d'Apache. N’étant pas protégé par Cloudflare en janvier 2023 il permet d’avoir un aperçu technique de comment était servi l’ensemble du site avant la mise en place de Cloudflare.

Côté DNS, cinq serveurs de noms sont utilisés : ns1.webedia-group.org, ns2.webedia-group.net, ns3.webedia-group.com, ns4.webedia-group.biz, ns5.webedia-group.app. Les deux premiers sont sur leur AS 35717 ; les trois derniers sont respectivement hébergés chez Scaleway, OVH, Gandi.

== Avant Respawn ==

Avant [[Projet Respawn|Respawn]], JVC était développé sur plusieurs langages différents côté back-end : on peut citer le C et le PHP. La base de données finale utilisait le moteur de base de données PostgreSQL. L'anarchie technique du back-end a menée au développement de [[Respawn]] (qui est également anarchique).

=== Les Cartes de visite ===

Les [[Carte de Visite|Cartes de visite]] étaient développés en PHP et avaient la particularité notable de stocker les données publiques de chaque utilisateur (par exemple, sa description personnelle) dans de simples fichiers HTML stockés sur disque : il n'y avait pas de requête SQL d'invoquée pour obtenir certaines données liées aux CDV. Lors de certains floods d'avis utilisateurs (notamment menés par ''UnifiedLinux''), les CDV retournaient aléatoirement des pages blanches. La cause est toujours inconnue.

=== Les forums ===

Les forums étaient en C, et [[Dargor]] les nommaient "modulaires".

=== Les articles ===

Les articles n'étaient pas mis en ligne immédiatement après leur rédaction. Un système de "compilation" était nécessaire et à effectuer manuellement afin que le site "compile" les articles pour qu'ils deviennent accessibles au public. On peut imaginer que ce système de compilation a été développé dans un but de gestion de charge applicative.

=== Modération ===

La modération des forums était liée à une authentification à 2 étapes, menant à l'attribution du cookie [[mocoedivxuejdom]] permettant la modération de certains forums selon les permissions attribuées à chaque modérateur. Cette deuxième étape était une page spéciale réclamant 5 mots de passe, qui avaient la particularité d'être remplis de caractères aléatoires et spéciaux.

=== Authentification ===

Le cookie [[wenvjgol]] était utilisé pour l'authentification.

=== La recherche des forums ===

La recherche des forums était connue pour être atrocement lente et affichant incorrectement la liste des résultats, des topics étaient manquants et s'affichaient une fois sur deux.

=== Sécurité informatique ===

Lorsqu'une IP tentait d'envoyer trop de requêtes HTTP (HTTPS n'était pas déployé à ce moment-là), le site redirigeait chaque requête HTTP vers une erreur 404. La page d'erreur 404 étant très peu consommatrice techniquement, cela permettait de désaturer la charge serveur en cas de DoS/DDoS.

Sur les CDV et les forums, il y a eu un grand nombre de failles XSS, notamment exploitées en masse par [[PyjamaSam]].

Le [[Captcha]] était également tout le temps cassé, permettant des floods de topics/messages/contributions. Cela a permis par exemple de créer un pseudo rang rubis en moins d'un jour, dont le pseudo était ''RubyOne'' (par ''UnifiedLinux'', qui a également créé un pseudo rang diamant en moins d'un jour via un flood de contributions).

== Respawn ==

[[Respawn]] a été développé entièrement en PHP côté back-end. Il utilise notamment des frameworks tels que Symfony côté forums, et des moteurs de templates tel que Twig. Respawn semble être divisé techniquement en plusieurs parties : en effet, on peut constater que certaines parties du site respectent le modèle vue-contrôleur (on peut citer les forums), bien que d'autres parties du site n'utilisent pas ce modèle et utilisent de l'url rewriting hardcodé dans des fichiers .htaccess. Respawn semble posséder une base de code identique entre JVC et [[ForumJV]] (désormais fermé), on pouvait constater de nettes interactions entre les 2 sites lorsque ForumJV était ouvert, interactions ayant menées à certains abus (ForumJV accordait des droits de modération sur son forum personnel, des failles de sécurité était donc existantes derrière ce privilège).

=== Schéma de base de données ===

Le schéma de base de données de Respawn semble anarchique et composé de mélange entre le Français et l'Anglais. Exemples de tables appartenant à Respawn : "get_compte_infos", "session_renew_v2", "jeu_get_v7". Notez le "v" à la fin de chaque table, laissant penser qu'il existe plusieurs versions de celles-ci.

==== Exemple d'appel en base de données ====
''SELECT out_id_type, out_nom_type, out_dirname_type, out_affichage, out_date_publication, out_date_modification, out_id_alias_auteur, out_id_groupe_auteur, out_ip, out_titre, out_texte, out_commentaire, out_visibilite, out_liaisons, out_tags, out_medias, out_version, out_fiche, out_jeu, out_data, out_url, out_id_jeux FROM jeu_get_v7 WHERE id_contenu = xxx''

=== Organisation technique ===

Comme dit précédemment, Respawn semble être un mélange de MVC et de code classique sans modèle particulier de respecté. Les fichiers du back-end sont également mitigés du côté de leur appellation, laissant encore droit au mélange entre Français et Anglais. Exemples de fichiers côté back-end :

''/opt/datas/JEUXVIDEO.COM/htdocs/forums/liste_topic.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/core/OiPDOStatement.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Transaction.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/GoogleTagManager.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Compte.php'' 
''/opt/datas/JEUXVIDEO.COM/app/controllers/forum/liste_topic.php'' 
''/opt/datas/JEUXVIDEO.COM/app/modeles/sso/Session.php'' 
''/opt/datas/JEUXVIDEO.COM/app/vendor/...''

=== Nommage des fonctions ===

Respawn possède aussi des fonctions dont le nommage est entre le Français et l'Anglais. Exemples de fonctions côté back-end :

''getInfoFromIdForum'' 
''loadMenu'' 
''checkMenuItem'' 
''getSingleton'' 
''getHtmlJeuForum'' 
''blocHtmlBoutiqueRandom''

=== Optimisations ===

Le back-end PHP utilise Memcache (https://www.php.net/manual/fr/book.memcache.php) afin de faire baisser la charge technique de l'applicatif.

=== Stockage des utilisateurs ===

Depuis Respawn, les utilisateurs de JVC sont référencés sous un identifiant numérique côté base de données, contrairement au fonctionnement de l'ancien JVC où les utilisateurs étaient référencés par leur pseudo (pouvant mener à des posts sur les forums avec des pseudos identiques organisés différemment côté minuscules/majuscules).

Il est possible d'obtenir son ID via la page permettant d'éditer votre profil, l'ID est à la fin de l'URL.

=== Les forums ===

Les posts des forums sont déclarés sur plusieurs serveurs différents. Les IDs de ceux-ci semblent aléatoires (bien qu'un offset était attribué pour les posts présents sur ForumJV). Les IDs sont choisis selon l'emplacement dans lequel la ressource sera stockée lors de la création du topic. Le choix de l'emplacement se fait à la création du topic, les messages dans le topic sont alors stockés dans le même emplacement. Il semblerait qu'il y ait 8 emplacements. ID + 8 pour accéder à la ressource suivante, et ID - 8 pour accéder à la ressource précédente.

Exemple de messages séquentiels:

* https://www.jeuxvideo.com/forums/message/905193382
* https://www.jeuxvideo.com/forums/message/905193390
* https://www.jeuxvideo.com/forums/message/905193398

L'ID est incrémenté de 8 à chaque fois. Tous ces messages sont répertoriés dans le 7ème serveur (<code>ID % 8</code>, donc <code>905193382 % 8 = 6</code>, 7ème).

À noter toutefois que les messages datant d'avant respawn sont complètement désordonnés, certainement dû à la migration durant respawn où la migration de ces messages a été effectué en parallèle.

=== Modération ===

La modération sur Respawn se nomme "Accès étendu". L'accès étendu peut être appelé via la page qui lui est dédiée : https://www.jeuxvideo.com/sso/auth.php ; il nécessite en revanche également un mot de passe, qui est envoyé via un lien sécurisé utilisable une seule fois par MP à chaque modérateur. A noter que le [[103]] est accessible à n'importe quel modérateur même sans authentification à l'accès étendu.

=== Authentification ===

Le cookie [[coniunctio]] est utilisé pour l'authentification.

=== Recherche des forums ===

La recherche des forums utilise le moteur de recherche Sphinx qui est intégré au site. La recherche des forums est limitée à 1 mois sur les blablas, elle peut être contournée via https://jvarchive.com/.

=== Sécurité informatique ===

Dans les débuts de Respawn, le site était rempli de failles permettant de faire exploser la charge du site. Il existait également de nombreuses failles sur [[ForumJV]] qui permettaient de modérer sans être modérateur, sur n'importe quel forum. Les failles ici citées ont en majorité été exploitées par [[edwado]].

Il a également existé une faille RCE (Remote Code Execution) exploitée par [[Tsain]], qui permettait d'injecter du CSS sur n'importe quelle partie du site (la faille fut très mal exploitée étant-donné que celle-ci n'était pas qu'une simple injection CSS mais bien une RCE où il était possible d'injecter un shell PHP).

=== JvCare ===

JvCare est un algorithme d'obfuscation des liens externes postés sur le site. Il a été développé depuis Respawn. Il permet d'éviter la création de backlinks qui pourraient optimiser indirectement le SEO de sites externes à Jeuxvideo.com.

Les codes ci-après permettent de décoder une chaîne obfusquée.

==== PHP ====

function jvCare(string $classe) : string {
$base16 = "0A12B34C56D78E9F";''
$lien = "";
$s = explode(" ", $classe)[1];
for ($i = 0; $i <= strlen($s)-1; $i += 2) {
$lien .= chr(strrpos($base16, $s[$i]) * 16 + strrpos($base16, $s[$i+1]));
}
return $lien;
}

==== JavaScript ====

function jvCake(classe) {
const base16 = '0A12B34C56D78E9F';
let lien = <nowiki>''</nowiki>;
const s = classe.split(' ')[1];
for (let i = 0; i < s.length; i += 2) {
lien += String.fromCharCode(base16.indexOf(s.charAt(i)) * 16 + base16.indexOf(s.charAt(i + 1)));
}
return lien;
}

==== Python ====

def jvcare(classe: str) -> str:
base16 = '0A12B34C56D78E9F'
url = <nowiki>''</nowiki>
s = classe.split()[1]
for i, j in zip(s[0::2], s[1::2]):
url += chr(base16.index(i) * 16 + base16.index(j))
return url

==== C ====

const char *__jvcarebase16 = "0A12B34C56D78E9F";

char *jvcare(const char *class) {
char *s = strchr(class, ' ') + 1;

int urllen = strlen(s) / 2;
char *url = malloc(urllen + 1);
for (int i = 0; i < urllen; i++) {
char pos1 = strchr(__jvcarebase16, s[i * 2]) - __jvcarebase16;
char pos2 = strchr(__jvcarebase16, s[i * 2 + 1]) - __jvcarebase16;
url[i] = pos1 * 16 + pos2;
}
url[urllen] = '\0';
return url;
}

== Phoenix ==

Phoenix est une partie de JVC développée en Node.js et utilisant React. Elle semble de plus en plus abandonnée, et nous n'avons pas beaucoup d'informations à son sujet. Phoenix utilise une API spéciale hébergée au sous-domaine [[Documentation_de_l%27API_Jeuxvideo.com#API_jvc.gg|''api.jvc.gg'']].

== Liens externes ==

* [http://www.journaldunet.com/solutions/itws/050426_it_jeuxvideo.shtml Interview sur l’architecture de jeuxvideo.com de 1997 à 2005] ([http://web.archive.org/web/20070629165914/http://www.journaldunet.com/solutions/itws/050426_it_jeuxvideo.shtml archive.org])

== Notes ==

<references />

== Voir aussi ==

* [[Documentation de l'API Jeuxvideo.com]]

{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Documentation de l'API Jeuxvideo.com

2024-07-26T14:47:05Z

HelloWorld5000 : Ajout du modèle ''Article de la qualité'' suite à la promotion de l'article dans la catégorie citée

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"forums" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]
[[Catégorie:Article de qualité]]

{{Article de qualité}}

Onlymaat (aka elsa)

2024-07-26T14:40:38Z

HelloWorld5000 : Ce malaise, t'as 13 ans ou quoi ?

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]
'''onlymaat''', ou encore '''akaelsa''', de son vrai nom Elsa Pereira de Lima, est une tiktokeuse militante féministe, souvent qualifiée d'[[AW]] et d'[[e-pop]]. Elle s'est en 2024 attirée les foudres des forums [[Onche.org]] et [[2Sucres]] après avoir créé une vidéo de réponse à un topic la concernant.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple « à les brûler vif ».[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressé et pour faire l'angoissée.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' {{CDV2S|Pseudo=S2ada}} poste également plusieurs topics comportant des nudes (authentique (leak de onlyfans) ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.
*[[Fichier:elsaplainte.png|gauche|vignette|259x259px|Image ironisant sur elsa portant plainte ]]'''Le 24 juillet 2024''', alors que certains pensaient l'affaire [[Tassé|tassée]], Elsa poste une vidéo<ref>https://www.tiktok.com/@itsonlymaat2/video/7395253617738976544?_r=1&_t=8oIQqJj0CdF</ref> où elle explique qu'elle a essayé de porter plainte mais que celle-ci n'a même pas été reçue par la police, faute de preuves caractérisant des menaces de mort, mais seulement pour de la diffamation<ref>https://www.tiktok.com/@itsonlymaat2/video/7395253617738976544?_r=1&_t=8oIQqJj0CdF</ref>. Elle essaye alors de porter plainte dans plusieurs commissariats comme elle annonce en story insta<ref>https://cloud.onche.org/37289873-5235-4322-bd5d-b79768fd1b1f!fR5NgWVviC</ref>, ayant constitué un dossier de "49 pages " selon elle, même si on ne sait pas à ce jour si un plainte a réussi a être réellement déposée.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|398x398px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui l'avaient critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, fait repris dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques qu'ils jugent médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.

== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
Fichier:6f2265fb-7dc6-45e1-9833-9e3b118ee7df!JG2Z3DRAmu.png
Fichier:elsakheyED.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode="nolines" widths="205px">
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-26T00:38:32Z

HelloWorld5000 : Va te faire foutre avec tes trolls fdp, la page finira par être lock donc tu te fatigues pour rien

Onlymaat (aka elsa)

2024-07-25T23:54:04Z

HelloWorld5000 :

Onlymaat (aka elsa)

2024-07-25T23:53:32Z

HelloWorld5000 : Retrait de l'en-tête sabotée

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]
'''onlymaat''', ou encore "akaelsa" de son vrai nom Elsa Pereira de Lima, est une tiktokeuse militante féministe, souvent qualifiée d'[[AW]] et d'[[e-pop]]. Elle s'est en 2024 attirée les foudres des forums [[Onche.org]] et [[2Sucres]] après avoir créé une vidéo de réponse à un topic la concernant.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple « à les brûler vif ».[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressé et pour faire l'angoissée.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' {{CDV2S|Pseudo=S2ada}} poste également plusieurs topics comportant des nudes (authentique (leak de onlyfans) ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.
*[[Fichier:elsaplainte.png|gauche|vignette|259x259px|Image ironisant sur elsa portant plainte ]]'''Le 24 juillet 2024''', alors que certains pensaient l'affaire [[Tassé|tassée]], Elsa poste une vidéo<ref>https://www.tiktok.com/@itsonlymaat2/video/7395253617738976544?_r=1&_t=8oIQqJj0CdF</ref> où elle explique qu'elle a essayé de porter plainte mais que celle-ci n'a même pas été reçue par la police, faute de preuves caractérisant des menaces de mort, mais seulement pour de la diffamation<ref>https://www.tiktok.com/@itsonlymaat2/video/7395253617738976544?_r=1&_t=8oIQqJj0CdF</ref>. Elle essaye alors de porter plainte dans plusieurs commissariats comme elle annonce en story insta<ref>https://cloud.onche.org/37289873-5235-4322-bd5d-b79768fd1b1f!fR5NgWVviC</ref>, ayant constitué un dossier de "49 pages " selon elle, même si on ne sait pas à ce jour si un plainte a réussi a être réellement déposée.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|398x398px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui l'avaient critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, fait repris dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques qu'ils jugent médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.

== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
Fichier:6f2265fb-7dc6-45e1-9833-9e3b118ee7df!JG2Z3DRAmu.png
Fichier:elsakheyED.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode="nolines" widths="205px">
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-25T23:52:22Z

HelloWorld5000 : Suppression du gras superflu + tournures légèrement plus objectives

Juste pour vous dire que je suis retourné à la police ce matin et cette dernière à validé ma plainte envers onche.org pour harcèlement, menace et incitation à la haine.

Tous les topics, les vidéos et les montages ainsi que c'est immonde article ont été sauvegardés par la police.

Je vous conseille de vous calmer très vite car ça va aggraver votre cas.

Bonne continuation. Elsa

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple « à les brûler vif ».[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressé et pour faire l'angoissée.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' {{CDV2S|Pseudo=S2ada}} poste également plusieurs topics comportant des nudes (authentique (leak de onlyfans) ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.
*[[Fichier:elsaplainte.png|gauche|vignette|259x259px|Image ironisant sur elsa portant plainte ]]'''Le 24 juillet 2024''', alors que certains pensaient l'affaire [[Tassé|tassée]], Elsa poste une vidéo<ref>https://www.tiktok.com/@itsonlymaat2/video/7395253617738976544?_r=1&_t=8oIQqJj0CdF</ref> où elle explique qu'elle a essayé de porter plainte mais que celle-ci n'a même pas été reçue par la police, faute de preuves caractérisant des menaces de mort, mais seulement pour de la diffamation<ref>https://www.tiktok.com/@itsonlymaat2/video/7395253617738976544?_r=1&_t=8oIQqJj0CdF</ref>. Elle essaye alors de porter plainte dans plusieurs commissariats comme elle annonce en story insta<ref>https://cloud.onche.org/37289873-5235-4322-bd5d-b79768fd1b1f!fR5NgWVviC</ref>, ayant constitué un dossier de "49 pages " selon elle, même si on ne sait pas à ce jour si un plainte a réussi a être réellement déposée.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|398x398px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui l'avaient critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, fait repris dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques qu'ils jugent médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.

== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
Fichier:6f2265fb-7dc6-45e1-9833-9e3b118ee7df!JG2Z3DRAmu.png
Fichier:elsakheyED.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode="nolines" widths="205px">
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-22T07:56:11Z

HelloWorld5000 :

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''onlymaat''', ou encore "akaelsa" de son vrai nom Elsa Pereira de Lima, est une tiktokeuse militante féministe, souvent qualifiée d'[[AW]] et d'[[e-pop]]. Elle s'est en 2024 attirée les foudres des forums [[Onche.org]] et [[2Sucres]] après avoir créé une vidéo de réponse à un topic la concernant.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple '''« à les brûler vif ».'''[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressé et pour faire l'angoissée.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (authentique (leak de onlyfans) ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui avaient oser la critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.
== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode="nolines" widths="205px">
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-22T07:55:21Z

HelloWorld5000 : Ça sabote fort ici

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''onlymaat''', ou encore "akaelsa" de son vrai nom Elsa Pereira Dupont de Ligonnès, est une tiktokeuse militante féministe, souvent qualifiée d'[[AW]] et d'[[e-pop]]. Elle est présidente d'une association de lutte contre le harcèlement sexuel et contre les pygargues a queues blanches Elle s'est en 2024 attirée les foudres des forums [[Onche.org]] et [[2Sucres]] après avoir créé une vidéo de réponse à un topic la concernant.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple '''« à les brûler vif ».'''[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressé et pour faire l'angoissée.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (authentique (leak de onlyfans) ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui avaient oser la critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.
== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode="nolines" widths="205px">
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-21T20:26:54Z

HelloWorld5000 : Annulation des modifications 155792 de [IP masquée] : Stop avec les pygargues

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''onlymaat''', ou encore "akaelsa" de son vrai nom Elsa Pereira Dupont de Ligonnès, est une tiktokeuse militante féministe, souvent qualifiée d'[[AW]] et d'[[e-pop]]. Elle est présidente d'une association de lutte contre le harcèlement sexuel et contre les pygargues a queues blanches Elle s'est en 2024 attirée les foudres des forums [[Onche.org]] et [[2Sucres]] après avoir créé une vidéo de réponse à un topic la concernant.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple '''« à les brûler vif ».'''[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressé et pour faire l'angoissée.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (authentique (leak de onlyfans) ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui avaient oser la critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.
== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode="nolines" widths="205px">
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-21T15:18:59Z

HelloWorld5000 : C'est quoi ce délire de pygargue wtf

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''onlymaat''', ou encore "akaelsa" de son vrai nom Elsa Pereira Dupont de Ligonnès, est une tiktokeuse militante féministe, souvent qualifiée d'[[AW]] et d'[[e-pop]]. Elle est présidente d'une association de lutte contre le harcèlement sexuel et contre les pygargues a queues blanches Elle s'est en 2024 attirée les foudres des forums [[Onche.org]] et [[2Sucres]] après avoir créé une vidéo de réponse à un topic la concernant.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple '''« à les brûler vif ».'''[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressé et pour faire l'angoissée.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (authentique (leak de onlyfans) ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui avaient oser la critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.
== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode="nolines" widths="205px">
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-20T19:09:59Z

HelloWorld5000 : Mise en page des dernières vidéos et retrait du gras superflu

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''onlymaat''', ou encore "akaelsa" de son vrai nom Elsa Pereira de Lima, est une tiktokeuse militante féministe, souvent qualifiée d'[[AW]] et d'[[e-pop]]. Elle est présidente d'une association de lutte contre le harcèlement sexuel. Elle s'est en 2024 attirée les foudres des forums [[Onche.org]] et [[2Sucres]] après avoir créé une vidéo de réponse à un topic la concernant.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple '''« à les brûler vif ».'''[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressée pour faire l'angoisser.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « j''uste jalouse pendant que ton ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (faux ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui avaient oser la critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.

== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.
{{clear}}
<div style="display:flex;">
<div style="padding-top:4.2px;">
<youtube width="30%">loYqhf_ejho</youtube>
</div>
<div style="margin-top:0">
<gallery mode=nolines widths=205px>
Fichier:videoelsaferrari.mp4|Le TikTok d'Elsa en réaction aux commentaires sur le forum.
</gallery>
</div>
</div>

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Discussion:Onlymaat (aka elsa)

2024-07-19T20:40:24Z

HelloWorld5000 :

== Sur l'utilisation du gras ==
Salut, j'ai enlevé les usages de la police en gras hors du chapeau et des dates pour garder un style cohérent avec le reste du wiki et éviter d'alourdir inutilement la lecture.

Je propose l'utilisation d'italiques à la place pour indiquer des passages ou des termes sur lesquels le rédacteur veut attirer l'attention du lecteur.

C'est pas pour faire chier mais vraiment dans une optique de confort de lecture :noel:

[[Utilisateur:Chanclarchiviste|Chanclarchiviste]] ([[Discussion utilisateur:Chanclarchiviste|discussion]]) 19 juillet 2024 à 21:13 (CEST)
-------------------------
Nan justement j'aime bien la faire avec des mots en gras de ce qu'on lui reproche, car beaucoup de khey vont lire l'article en travers et se demande pk on "s'attaque " a cette meuf :hap:

-------------------------
Je rejoins Chanclarchiviste à propos de la typographie de l'article. Les articles de JVFlux ne devraient pas être utilisés à des fins tendancieuses et ne devraient donc pas être tournés de telle manière qu'ils incitent à prendre parti pour ou contre qui que ce soit. Ce n'est pas le rôle du wiki et c'est pour cela que j'avais déjà enlevé le gras superflu.

[[Utilisateur:HelloWorld5000|HelloWorld5000]] 19 juillet 2024 à 22:40 (CEST)

Onlymaat (aka elsa)

2024-07-19T18:37:21Z

HelloWorld5000 : /* Délires et parodies */ Mise en page

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''onlymaat''', ou encore "akaelsa" de son vrai nom Elsa Pereira de Lima, est une tiktokeuse féministe [[AW]] et [[e-pop]] et la présidente d'une association, s'étant attirée les foudres des forums [[onche.org]] et [[2Sucres]] après le partage d'une de ses vidéos.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2''<ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient les commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple '''« à les brûler vif ».'''[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour "exposés" par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressée pour faire l'angoisser.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « j''uste jalouse pendant que [s]on ex vit sa meilleure vie ''»<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' allait se faire arrêter par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés, cette dernière les publiant publiquement sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona''{{CDVonche|Pseudo=PUITsansFOND}} , qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrets.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de 7 heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (faux ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de son harcèlement commis envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des incohérences troublantes dans sa narration des faits,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des confusion concernant les lieu et moment exact de la supposée agression.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, dont elle ne souhaite jamais rendre publiques pour des « raisons personnelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause de harcèlement moral et répété de sa part contre certains utilisateurs qui avaient oser la critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de camoufler ses performances académiques médiocres par des accusations proférées contre ses ex comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.

== Délires et parodies ==

<gallery>
Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png
Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png
Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png
</gallery>

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de Madzona, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.

<youtube width="50%">loYqhf_ejho</youtube>
[[Fichier:videoelsaferrari.mp4|200px|Choco jsp comment on resize une vidéo bordel ]]

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-19T15:45:05Z

HelloWorld5000 :

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''itsonlymaat''', de son vrai nom Elsa Pereira de Ligonnès, est une tiktokeuse féministe et la présidente d'une association « contre les violences sexistes et sexuelles », s'étant attirée les foudres des forums [[onche.org]] et [[2Sucres]] où est elle considérée comme une [[AW]] après le partage d'une de ses vidéos.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2'' <ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient certains commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple « à les brûler vif ».[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour exposés par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressée pour faire l'angoisser.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que [s]on ex vit sa meilleur vie »<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' s'était fait arrêté par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés. Elsa publie les réactions des forumeurs sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona'', qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrêts.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de sept heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (faux ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de harcèlement envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des « incohérences troublantes » dans sa narration,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des négligences concernant les lieu et moment exact des faits.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, bien qu'elle ne souhaite jamais les rendre publiques pour des « raisons personelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause « de harcèlement moral et répété » de sa part contre certains utilisateurs qui l'avaient critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, attitude considérée comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de justifier ses performances académiques médiocres par des accusations proférées contre ses exs comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.

== Galerie médiatique ==

[[Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png|vignette]]
[[Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png|vignette]]
[[Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png|vignette|128px]]

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de ''PuitSansFond''{{CDVonche|Pseudo=PuitSansFond}}, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.

[[Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png|vignette|127px]]
<youtube width="100%" height="300px">loYqhf_ejho</youtube>
[[Fichier:videoelsaferrari.mp4|200px|Choco jsp comment on resize une vidéo bordel ]]

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Onlymaat (aka elsa)

2024-07-19T15:44:46Z

HelloWorld5000 : Correction de fautes d'orthographe et de syntaxe

[[Fichier:2914e12f-1969-499a-a8b4-ab181360ed5f!2ekeffbkzi.png|vignette|352x352px|Image représentant la tiktokeuse Elsa et un sticker de onche]]

'''itsonlymaat''', de son vrai nom Elsa Pereira de Ligonnès, est une tiktokeuse féministe et la présidente d'une association « contre les violences sexistes et sexuelles », s'étant attirée les foudres des forums [[onche.org]] et [[2Sucres]] où est elle considérée comme une [[AW]] après le partage d'une de ses vidéos.

==Déroulé sur le forum ==

* '''Le 13 juillet 2024''', le forumeur ''choah''{{CDVonche|Pseudo=choah}} crée un [[topic]] où il partage une vidéo de la tiktokeuse ''itsonlymaat2'' <ref>https://onche.org/topic/590746/ayaaa-cette-teen-sans-etudes-c-est-la-faute-de-son-violeur</ref> qui accuse son ex-petit ami, Maxime, d'agression sexuelle après une relation sexuelle consentie sous alcool. Ce dernier « vivrait sa meilleur vie à la fac » et « roulerait en Ferrari » selon les mots d'Elsa.

*'''Le 17 juillet 2024''', ce topic anodin devient rapidement un [[délire]] lorsque l'intéressée est mise au courant du topic la concernant par un ''délateur''. Elle réagira aux commentaires du forum la concernant dans un TikTok<ref>https://vm.tiktok.com/ZGetTQX2V/</ref> reposté par un [[khey]] dans un topic qui atteindra 28 pages<ref>https://onche.org/topic/594634/avis-sur-cette-tiktokeuse-qui-rage-sur-le-fofo</ref>.
*Beaucoup de kheys furent alors agacés par les propos que comportaient certains commentaires sous la vidéo, commentaires qu'Elsa avait parfois liké en guise d'approbation, alors qu'ils appelaient clairement à la violence contre les membres du forum, par exemple « à les brûler vif ».[[Fichier:messageinsulteelsa.png|vignette|250px|Messages de menaces et d'insultes envers le forum suite au 1er Tiktok.]]
*Cette exposition médiatique du forum crée un engouement qui motivera certains forumeurs à se faire remarquer pour être à leur tour exposés par la tiktokeuse. Plusieurs topics sont alors créés dans la foulée et les premiers stickers commencent à paraître<ref>https://onche.org/topic/595862/j-ai-depose-plainte-contre-la-tik-tokeuse</ref><ref>https://onche.org/topic/594898/tiktok-message-de-soutien-a-la-victime-de-viol</ref><ref>https://onche.org/topic/594654/bon-bah-onche-va-fermer-c-etait-un-plaisir-les-kheys</ref><ref>https://onche.org/topic/595745/akaelsa-message-aux-followeuses-de-akaelsa</ref>. Un khey trollera les autres en prétendant avoir trouvé des nudes de l'intéressée pour faire l'angoisser.
*En réponse, Elsa publiera deux nouvelles vidéos TikTok, ultérieurement supprimées. La [https://streamable.com/oh2w6w première vidéo] ciblaient des messages de divers forumeurs<ref>https://streamable.com/oh2w6w</ref>. La [https://streamable.com/rc4xxy seconde vidéo] reprend un montage moqueur d'un utilisateur fait à son encontre, indiquant qu'elle est « juste jalouse pendant que [s]on ex vit sa meilleur vie »<ref>https://streamable.com/rc4xxy</ref>.
*D'autres kheys trouvant que l'affaire va trop loin et craignant la visite de [[Gilbert]] ou la fermeture du forum se sont mis à la défendre. À la suite de diverses rumeurs selon lesquelles ''choah'' s'était fait arrêté par la police, le forumeur ''Motorazr''{{CDVonche|Pseudo=Motorazr}} crée un avatar « Je suis choah » par solidarité.
*Son LinkedIn ainsi qu'un reportage dans lequel elle apparaît pour son association sont rapidement trouvés. Elsa publie les réactions des forumeurs sur son compte Instagram, fait qui sera à l'origine d'autres moqueries.[[Fichier:Avatar Je suis choah.jpg|vignette|211px|Avatar « Je suis choah », en soutien à l'utilisateur épony..]]
*Le lendemain, Elsa publie une nouvelle vidéo en réponse au forum ainsi qu'une story Instagram. Une parodie musicale a également été créée<ref>https://streamable.com/vf7v6e</ref> en son honneur, suivie d'une autre par ''MadZona'', qui sera rapidement épinglée<ref>https://onche.org/topic/596170/meuf-tiktok-brisee-elle-chante-sa-douleur-en-vocaroo</ref> tandis que le modérateur ''Blondin'' crée un topic pour se moquer d'Elsa<ref>https://onche.org/topic/595818/ici-on-parle-de-la-tiktokeuse-folle</ref>. Face à cette exposition, Elsa continue de publier des vidéos sur TikTok, résumant la situation de son point de vue<ref>https://streamable.com/fbpsw5</ref>. Ces vidéos ont été perçues par beaucoup comme des tentatives de victimisation sans apport d'arguments concrêts.
*Elle vérifiera de nombreux topics sous le pseudonyme ''onlymaat''{{CDVonche|Pseudo=onlymaat}}, passant plus de sept heures d'affilée sur le forum, ce qui a conduit quelques forumeurs à la considérer comme une [[Kheyette|kheyettes]] ou une [[AW]], appréciant secrètement l'attention donnée par le forum envers sa personne.
*Pendant ce temps-là sur le forum [[2Sucres]], l'utilisateur ''S2ada'' poste également plusieurs topics comportant des nudes (faux ?). Jugées hors-charte et donc supprimées par la modération, les photos sont néanmoins disponibles sur demande MP à ''S2ada'' sur 2Sucres<ref>https://2sucres.org/p/Q9OKa</ref>, ce qui étend le drama au-delà d'Onche.

==Controverses des accusations ==
[[Fichier:Messagelsa.png|vignette|250px|Message d'Elsa où elle se plaint de s'être fait supprimer son compte TikTok à cause de harcèlement envers d'autres utilisateurs.]]
*Elsa, qui se définit elle-même comme « misandre<ref>https://www.tiktok.com/@itsonlymaat2/video/7391910279430409505</ref> » et avoue avoir une profonde aversion envers les hommes, a suscité des questionnements concernant les allégations adressées contre Maxime. Beaucoup de forumeurs ont en effet émis de grands doutes quant à sa version des faits, et cela en sachant que plusieurs utilisateurs ont trouvé des « incohérences troublantes » dans sa narration,<ref>https://onche.org/topic/596374/preuve-que-la-teen-ment</ref>tel que des négligences concernant les lieu et moment exact des faits.
*La justice avait aussi classé toutes ses plaintes sans suite, ce qui interroge sur la véracité des preuves qu'elle prétend détenir, bien qu'elle ne souhaite jamais les rendre publiques pour des « raisons personelles ».[[Fichier:81bd9689-3dc0-407f-be34-7ee26a12d1ec!dWSwEtbUTz.png|vignette|199px|Sticker représentant la Ferrari de Maxime.|gauche]]
* Elsa s'était aussi fait supprimer son ancien compte TikTok plusieurs semaines avant la genèse du délire créé autour d'elle, pour cause « de harcèlement moral et répété » de sa part contre certains utilisateurs qui l'avaient critiquée, et ce malgré une réclamation infructueuse qu'elle adressa au service de modération<ref>https://www.tiktok.com/@itsonlymaat2/photo/7391954003845713184</ref>.
*Beaucoup ont alors accusé Elsa de proférer de fausses accusations contre Maxime, tantôt par rancœur suivant une rupture amoureuse, tantôt par appât du gain. L'intéressée a notamment insisté sur le fort capital que posséderait Maxime ainsi que sur sa Ferrari, attitude considérée comme une preuve de sa jalousie, reprise dans de nombreux délires et topics.
* D'autres lui reprochent enfin de justifier ses performances académiques médiocres par des accusations proférées contre ses exs comme le topic initial le laisse suggérer : elle a en effet accusé un de ses cinq agresseurs de s'être « servi d'elle<ref>https://www.instagram.com/p/C4YfYOaiMM6/?img_index=3</ref> » durant toute leur relation, fait qui d'après elle l'a menée à ne plus pouvoir étudier la même faculté que la sienne.

== Galerie médiatique ==

[[Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png|vignette]]
[[Fichier:f1486a79-b90e-4438-900c-5f8dc86fad0b!yjEICcKnQq.png|vignette]]
[[Fichier:956fe870-b615-4cc7-a788-7ee6b732df60!HumuAVwrJi.png|vignette|128px]]

De nombreux sons et stickers ont été produits autour du délire, mentionnant Elsa ou la Ferrari, comme le son de ''PuitSansFond''{{CDVonche|Pseudo=PuitSansFond}}, réalisé avec l'aide de ''Trapvador''{{CDVonche|Pseudo=Trapvador}} pour la miniature.

[[Fichier:9efc5882-eb8f-4ff4-ae69-545e13b929cf!78jWYTW7S8.png|vignette|127px]]
<youtube width="100%" height="300px">loYqhf_ejho</youtube>
[[Fichier:videoelsaferrari.ogv|200px|Choco jsp comment on resize une vidéo bordel ]]

{{SectionRéférences}}
[[Catégorie:Personnalité externe]]
[[Catégorie:Affaire]]
{{TableauCatégoriePersonnalité}}
[[Catégorie:Délire]]
[[Catégorie:Onche.org]]
[[Catégorie:Topic]]
[[Catégorie:Malveillance]]
[[Catégorie:Raids et Agissements]]

Fichier:videoelsaferrari.ogv

2024-07-19T15:36:26Z

HelloWorld5000 : Fichier téléversé avec MsUpload

Fichier téléversé avec MsUpload

Fichier:videoelsaferrari.ogg

2024-07-19T15:32:55Z

HelloWorld5000 : Fichier téléversé avec MsUpload

Fichier téléversé avec MsUpload

FrenchMVP

2024-07-19T14:56:58Z

HelloWorld5000 :

{{Bannière Source}}
{{Bannière Info|Contenu=Une réécriture de l'article dans un style davantage objectif et moins péremptoire (rappelons que l'affaire n'est pas encore terminée) doit être envisagée.}}

[[Fichier:avatarfrenchmvp.png|vignette|Avatar utilisé par FrenchMVP.]]
[[Fichier:passeportfrenchmvp.png|vignette|Passeport supposé du forumeur FrenchMVP.]]
''FrenchMVP'' {{CDV|Pseudo=frenchmvp}} est un forumeur du [[Blabla 18-25 ans|18-25]] aux origines douteuses connu pour ses nombreux topics haineux et pédant, dans lesquels il se vante d'être expatrié en Chine et de mener une vie de rêve. Il qualifie ses détracteurs de "[[Facho|chof]]" et n'hésite pas à les menacer de mort, revenant sous des centaines de comptes différents.

== L'affaire du faux expatrié ==
Dans la nuit du 17 au 18 juillet 2024, un [[topic]] nommé "[https://jvarchive.com/forums/42-51-74589329-1-0-1-0-le-forumeur-french-mvp-a-disparu Le forumeur 'FrenchMVP' a disparu]" fait son apparition. Le topic parle d'une [[Fake|escroquerie]] que ''FrenchMVP'' aurait fait subir à plusieurs [[Khey|kheys]] en Chine. Le topic qui fait d'abord un [[bide]] commence à prendre de l'ampleur à partir de 4 heures du matin, où plusieurs forumeurs se sont donné rendez-vous pour dénoncer l'attitude arrogante de ''FrenchMVP''. Les messages de plus en plus insultants envers ''FrenchMVP'' s'enchaînent quand le principal intéressé fait son apparition, visiblement fou de rage<ref>https://jvarchive.com/forums/message/1262184785</ref>. Comme à son habitude, ''FrenchMVP'' commence à enchaîner des insultes et menace les personnes présentes sur le topic. Il persiste sur son expatriation en Chine et envoie même une photo de son passeport français accompagné d'un passeport chinois avec une feuille mentionnant son pseudo<ref>https://jvarchive.com/forums/message/1262186017</ref>. Sauf que malheureusement pour lui, un forumeur lui mentionne que la double nationalité est interdite en Chine<ref>https://jvarchive.com/forums/message/1262186105</ref>, à quoi ''FrenchMVP'' lui répond : "C'est le passeport de ma meuf<ref>https://jvarchive.com/forums/message/1262186185</ref>" il a ensuite disparu du topic.

=== Le retour et la fin d'un homme brisé ===
[[Fichier:frenchmvpbrise.png|vignette|FrenchMVP suppliant de DDB un topic en échange d'une clé steam.]]
''FrenchMVP'' fait son retour sur un nouveau topic ""[https://jvarchive.com/forums/42-51-74603504-1-0-1-0-dedi-chine-pour-ceux-qui-aiment-la-pls Dédi Chine pour ceux qui aiment la PLS]" plusieurs heures après son humiliation, il apporte avec lui plusieurs photos censées démontrer sa présence physique en Chine. Sauf que les photos prises sont floues et de basse qualité, le forumeur en question se contente de tenir un bout de papier tordu dans la main avec son pseudo inscrit dessus. C'était sans compter sur la ténacité des forumeurs du 18-25, qui ont vu la supercherie de ''FrenchMVP''.

Deux heures plus tard, un topic démontrant la fraude de ''FrenchMVP'' est créé "[https://jvarchive.com/forums/42-51-74586478-1-0-1-0-ayyyyyaa-la-chute-de-frenchmvp AYYYYYAA, la CHUTE de FRENCHMVP]". Le topic mentionne les incohérences, notamment une photo avec le logo d'une enseigne chinoise partiellement flouté<ref>https://image.noelshack.com/fichiers/2024/29/4/1721297668-873edfda13f3063a9dd2a25c9996e96.jpg</ref>, le soi-disant expatrié en Chine aurait en fait pris une photo d'une enseigne depuis Google Maps avec son pseudo écrit devant, s'ensuivront des dizaines de pages où le principal intéressé reviendra avec plusieurs comptes secondaires pour tenter de se défendre avant de disparaître complètement du forum.

== Références ==
<references />
[[Catégorie:Forumeur du 15-18]]
[[Catégorie:Brisé]]

WEBM

2024-07-09T16:29:09Z

HelloWorld5000 : /* Plateformes d'hébergement et de relais */

[[File:WebM_logo.png|vignette|250px|Le logotype officiel du format WebM.]]

'''WEBM''' (stylisé ''WebM'') est un format de fichier vidéo principalement destiné à être utilisé sur le Web. Ce terme est par extension utilisé par le [[Blabla 18-25 ans|18-25]] pour qualifier les vidéos que se partagent les [[forumeur|forumeurs]] entre eux. Les WEBM sont généralement appréciés, si bien que certains forumeurs se sont spécialisés dans ce domaine. Les topics comportant en titre une balise ''[WEBM]'' indiquent qu'ils contiennent une telle vidéo.

= Contenu =
== Dénomination ==
Bien que WEBM désigne à l'origine un format de fichier vidéo spécifique, on nomme habituellement ''WEBM'' toute vidéo partagée entre [[forumeurs]], hébergée et relayée sur un service Web prévu à cet effet (voir [[WEBM#Plateformes d'hébergement et de relais|la section attitrée de cet article]]), avec comme seul intérêt la vidéo en elle-même. Une faible minorité de forumeurs puristes prône l'utilisation de ce terme exclusivement concernant les fichiers portant cette extension<ref>https://www.jeuxvideo.com/forums/message/1214151400</ref>. 
Les vidéos présentes sur les réseaux sociaux, YouTube ou toute autre plateforme très modérée ne sont quant à eux habituellement pas vus comme des WEBM car ce style de contenu est souvent éloigné de ce qu'aiment se partager les forumeurs (voir [[WEBM#Nature des WEBM|la section suivante]] pour plus de détails).
== Nature des WEBM ==
Les WEBM partagés par les forumeurs ont principalement pour but de faire rire ou de surprendre. La plupart du temps, les WEBM mettent en scène des vidéos insolites ou à caractère humoristique. Loin d'êtres niais et gentillets, les WEBM partagés par les forumeurs se révèlent souvent trash voire très explicites.

Plus précisément, il peut s'agir d'accidents routiers, de chutes, d'incidents matériels ou industriels impliquant directement des humains ou non, de scènes de violence relativement légères et rarement gores, ou de nudité, mais également de redpills sur les relations sociales, de contenus glissants etc.

Ceci dit, une partie non-négligeable des WEBM partagés ont un objectif purement humoristique, souvent par leur attrait, contenu ou intitulé absurde.

=== Chine ===
Certains types spéciaux de WEBM ont émergé, par exemple sur la Chine où le but principal des WEBM partagés (réservés à un public averti) est de montrer des accidents du travail ou accidents industriels récurrents en Chine, ainsi que le manque apparent d'empathie qu'éprouvent les Chinois envers leurs compatriotes lorsqu'ils sont victimes d'accidents routiers, en les laissant pour morts, ou encore le décalage qu'il peut y avoir entre les sociétés européennes et asiatiques.<ref>https://www.jeuxvideo.com/forums/42-51-60397834-1-0-1-0-putain-les-webm-du-pave-chine.htm</ref>
On retrouve la plupart de ces WEBM dans le [[Pavé Chine|pavé Chine]].

=== Pneus tueurs ===
Cette appellation est réservée aux WEBM filmant des scènes de pneus qui lorsqu'ils se décrochent de leur châssis peuvent causer de gros dégâts humains ou matériels. Une [[boucle]] est alimentée par le forumeur ''PneuTueur'' à ce sujet <ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=pneus%20tueurs</ref>. Il semble que l'expression ait été pour la première fois utilisée sur [https://www.jeuxvideo.com/forums/42-51-70854977-1-0-1-0-webm-les-pneus-tueurs-uniquement-en-chine-etonnant.htm ce topic], et a été largement popularisée depuis lors.

=== WEBM du malaise ===
{{Article connexe|Malaisologie}}
[[File:webm-malaise.png|vignette|200px|Le topic ''WEBM du malaise'' du nouvel an 2023.]]
Certains WEBM se distinguent des autres par leur capacité à provoquer un malaise considérable chez les forumeurs : il s'agit des WEBM dits « du malaise », mettant souvent en scène des personnages archétypaux du [[french dream]] (comme des [[Magalie]]) ou des ''cas sociaux'' de TikTok.<ref>https://www.jeuxvideo.com/forums/42-51-71308627-1-0-1-0-boucle-cest-lheure-des-webm-du-malaise.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71498712-1-0-1-0-soiree-nouvel-an-webm-la-compilation-ultime-des-webm-du-malaise.htm</ref> C'est par exemple le cas de la vidéo [[Et Tic et Tac hein hein|''et tic et tac hein hein'']].

== Plateformes d'hébergement et de relais ==
Les plateformes d'hébergement sont les services Web qui hébergent les WEBM dont les forumeurs se partagent les liens. Souvent, ce sont ces derniers qui ajoutent eux-mêmes la vidéo sur une plateforme telle que Streamable ou webmshare, mais il se peut également qu'ils partagent le lien "brut" amenant à la vidéo originelle (liens [[4chan]], Reddit, etc.). 
Les plateformes d'hébergement/relais de WEBM les plus utilisées par les forumeurs sont (par ordre approximatif de popularité) :
* [https://streamable.com Streamable]
* [https://webmshare.com webmshare]
* [https://4chan.org 4chan] (notamment le board ''/gif/'')
* [https://issoutv.com/ IssouTV]
* [https://webm.red/ webm.red]
* [https://catbox.moe/ catbox.moe]
* [https://orbitum.space/ orbitum.space]
* [https://www.risishack.com/ RisiShack]
* [https://www.reddit.com Reddit] (notamment les subreddits ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'').

Stremable et webmshare sont les plateformes les plus populaires sur le forum. Streamable a l'avantage de prendre en charge la majorité des formats vidéo (dont WEBM et MP4) mais ne permet pas de télécharger nativement du contenu, contrairement à webmshare qui n'héberge que les fichiers WEBM et autorise le téléchargement de vidéos. Les contenus choquants ou illégaux sont occasionnellement supprimés sur Streamable, et leur auteur banni, ce qui n'arrive visiblement jamais sur webmshare : il semble que ce soit la plateforme la plus stable. De plus, il est nécessaire de créer un compte sur Streamable afin que les vidéos uploadées y soit conservées plus d'un jour, tandis que webmshare peut être utilisée en tant qu'invité. Le contenu hébergé sur webmshare ne peut être lu sur iPhone<ref>https://www.jeuxvideo.com/forums/42-51-70753532-1-0-1-0-tu-as-l-iphone-14-oui-je-ne-peux-pas-lire-les-webm.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71211520-1-0-1-0-j-arrive-pas-a-lire-les-webm-sur-mon-iphone-13.htm</ref>. Les deux demeurent (septembre 2023) largement en tête quant au nombre de vidéos partagées sur le forum. 

IssouTV a été comme son nom l'indique spécialement créé pour les utilisateurs de [[jeuxvideo.com|JVC]] et demeure assez utilisé. 

Le board ''/gif/'' de [[4chan]] contient un grand nombre de vidéos pornographiques mais également du contenu trash et gore. Très souvent, les contenus hébergés sur le ''/gif/'' de 4chan sont supprimés quelques semaines voire mois après ; on ignore s'il s'agit de l'action d'administrateurs ou d'un système automatique. Ainsi, les liens 4chan des anciens topics ne redirigent souvent que vers une erreur 404. Il est donc plutôt recommandé de télécharger le contenu hébergé sur 4chan et de le déposer sur une plateforme plus fiable. 

webm.red est une alternative à webmshare peu utilisée mais qui présente à peu près les mêmes fonctionnalités (prise en charge du format WEBM seulement, possibilité de télécharger les vidéos, etc.). 

catbox.moe est une plateforme acceptant toutes les extensions jusqu'à 200 Mo, ce qui fait qu'il n'est pas rare de voir des liens dirigeant vers celle-ci sur le forum. Elle semble également peu modérée. 

Les threads Reddit ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'' contiennent quant à eux du contenu relativement trash. 

La plateforme décentralisée ''orbitum.space'', gérée par des [[forumeurs]], accueille parfois des vidéos censurées sur ''jeuxvideo.com'' ; RisiShack, très peu utilisé, héberge des fichiers MP4.

Il est à noter que les topics comportant un lien YouTube, Twitter ou TikTok portent généralement une balise ''[WEBM]'' bien qu'ils ne puissent être considérés comme tel au sens strict. Certains forumeurs puristes ne manquent pas de le faire remarquer.<ref>https://jvarchive.com/forums/42-51-71462933-1-0-1-0-webm-ce-boule-va-vous-rendre-maboule</ref>

=== Anciennes plateformes d'hébergement ===
Il semble que d'autres plateformes aient été relativement populaires dans le passé ; c'est notamment le cas de ''webm.land'' et de ''yuki.la''.<ref>https://www.jeuxvideo.com/forums/42-51-55865982-1-0-1-0-webm-no-trash-hun-j-veux-pas-de-410-moi-svp.htm</ref> Ces services Web sont aujourd'hui fermés et inaccessibles. Il en est de même pour le contenu qui avait été hébergé dessus.

=== Script ===
Un [[script|userscript]] ''StreamableDownloader'' a été développé par un membre du forum pour permettre aux utilisateurs de télécharger les vidéos hébergées sur [https://streamable.com Streamable], voir [https://greasyfork.org/fr/scripts/453105-streamabledownloader la page d'accueil du script].

=== WEBM originaux ===
La plupart du temps les WEBM sont relayés sur les plateformes précédemment citées, mais les originaux sont souvent trouvés sur des sites trashs/gores tels que WebChoc, Bestgore, Kaotic, et auparavant LeakReality avant qu'il ne soit supprimé. Les liens vers ces plateformes sont cependant très rares afin de minimiser le risque de censure, et les forumeurs préfèrent uploader le contenu en question sur une des plateformes précédemment citées.
Certains WEBM proviennent directement de TikTok mais semblent être beaucoup moins appréciés par la communauté du fait de leur contenu jugé souvent peu intéressant et de la désapprobation générale de ce réseau social par le forum. On peut également retrouver des WEBM hébergés à l'origine sur YouTube ou Twitter. Ces trois derniers étant plus strictement modérés, ce sont souvent des WEBM softs qui découlent de là-bas. De ce fait, on leur préfère la balise ''[VIDÉO]'' (voir [[#Balise_VIDÉO|la sous-partie éponyme de cet article]]).

= Topics WEBM =
Les [[topic|topics]] WEBM sont très courants et très populaires sur le [[Blabla 18-25 ans|18-25]], mais demeurent trouvables presque exclusivement sur ce forum. On y compte environ une vingtaine de nouveaux topics WEBM par jour<ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=webm</ref>.

== Types de topics WEBM ==
On distingue deux types de topics WEBM :
* Des topics à "WEBM unique" ayant pour but de présenter un seul WEBM, dont le lien est présent dans le premier message de l'[[OP]]. 
[https://www.jeuxvideo.com/forums/42-51-71425835-1-0-1-0-webm-il-crie-woop-woop-puis-fait-une-prise-de-catch-a-son-micro-ondes-et-devient-tetraplegique.htm <nowiki>[WEBM] Il crie « WOOP WOOP » puis FAIT une PRISE de CATCH à son MICRO-ONDES et devient TÉTRAPLÉGIQUE</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70627502-1-0-1-0-webm-il-colle-une-voiture-sur-l-autoroute-la-selection-fut-naturelle.htm <nowiki>[WEBM] Il colle une VOITURE sur l'AUTOROUTE, la sélection fut NATURELLE</nowiki>]
* Ainsi que des topics "compilation" où l'auteur poste en continue des WEBM pendant plusieurs minutes ou dizaines de minutes (dépendant de la quantité de WEBM dont l'[[OP]] est en possession, de la réception du topic par les autres forumeurs, et surtout de la réaction de la [[modération]]). 
[https://www.jeuxvideo.com/forums/42-51-71421226-1-0-1-0-webm-ils-jouent-a-biere-pong-un-pere-noel-apparait-et-se-casse-le-coccyx.htm <nowiki>[WEBM] Ils jouent à BIÈRE-PONG, un PÈRE NOËL APPARAÎT et se CASSE le COCCYX</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71450605-1-0-1-0-webm-il-evite-de-justesse-sa-tronconneuse-se-remet-en-question.htm <nowiki>[WEBM] Il évite de justesse sa TRONÇONNEUSE, se REMET en QUESTION</nowiki>] 

Bien que les topics à WEBM unique soient les plus courants sur le forum, les topics de compilation sont généralement très appréciés par la planète forum : ils montent facilement à plusieurs centaines de connectés et à une dizaine de pages. Il arrive souvent que d'autres amateurs de WEBM y rejoignent l'auteur pour poster leurs vidéos.

=== Topics [[fake|fakes]] ===
Certains topics [[troll|trolls]] annoncent dans leur titre une vidéo imaginaire à l'intitulé très aguicheur et insolite, où le premier message est parfois accompagnés de la mention [[post ou cancer]] ou ses dérivés, ''pourquoi as-tu cliqué ?'', ''"cette vidéo n'existe pas'', ''j'aimerais bien voir ça'', simplement dans le but d'attirer des connectés sur le topic. S'ensuit alors des réponses ironiques de type ''pour voir la vidéo'' ou encore ''t'as oublié le lien''. En voici deux exemples : 
[https://www.jeuxvideo.com/forums/42-51-71421330-1-0-1-0-webm-il-plante-une-hache-sur-un-cheval-qui-le-catapulte-dans-le-composte.htm <nowiki>[Webm] Il plante une hache sur un cheval qui le catapulte dans le composte</nowiki>]. 
[https://www.jeuxvideo.com/forums/42-51-71450141-1-0-1-0-webm-cette-japonaise-chie-une-buche-de-noel-dans-l-assiette-de-son-copain.htm <nowiki>[WEBM] Cette JAPONAISE CHIE une bûche de noël dans l'assiette de son COPAIN</nowiki>]. 

Il est évident que ces topics sont très peu appréciés et souvent [[DDB]] en masse, puisqu'ils occasionnent une déception chez les forumeurs ayant cliqué.

=== Certification de [[nofake]] et [[éclaireur]] ===
[[Fichier:nofake sticker.png|vignette|200px|Le fameux sticker nofake étant généralement admis comme preuve incontestable d'un nofake.]]

Parallèlement aux topics fake, la certification de [[nofake]], réalisée par un forumeur autre que l'auteur, est un moyen pour ceux qui ont cliqué sur le topic de savoir si le titre est en bonne adéquation avec le contenu de la vidéo présentée. Ces certifications, qui permettent à la fois de faire gage de qualité et d'[[up]] le topic concerné, sont parfois demandées par l'[[OP]] dans son post pour démontrer la véracité du titre aussi invraisemblable soit-il. 
On note diverses déclinaisons de cette certification, telles que : [[le titre est malheureusement nofake|''Le titre est malheureusement nofake'']], ''Je certifie que le titre de l'annotateur principal de ce fil de discussion est en total adéquation avec le contenu du présent court-métrage présenté sur cette page HTML sur laquelle vous naviguez actuellement.'', etc. 
L'[[éclaireur]], quant à lui, est parfois demandé sur les topics WEBM par un forumeur réticent à l'idée de cliquer sur le lien partagé par l'auteur à cause d'un titre de topic douteux, de peur de tomber sur un screamer ou du contenu gore, choquant. Les éclaireurs ont ainsi pour mission de vérifier la vidéo et de signaler si cette dernière est ''safe'' ou non. L'éclaireur peut dans la foulée réaliser la certification de nofake.

== Titres ==
Les titres de topics WEBM sont souvent aguicheurs et insolites ; ils caricaturent les contenus ''putaclicks'' d'Internet en reprenant leurs éléments de langage. Parmi ces derniers, nous pouvons citer entre autres : ''la suite risque de vous surprendre'', ''ça tourne mal'', ''sa réaction est étonnante'', etc. 
[https://www.jeuxvideo.com/forums/42-51-71483319-1-0-1-0-webm-il-dort-dans-son-lit-se-mange-une-branche-sa-pasteque-tombe-dans-l-eau.htm <nowiki> [WEBM] Il dort dans son lit, se mange une branche, sa pastèque tombe dans l'eau </nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70167283-1-0-1-0-webm-il-tente-le-bah-sort-la-suite-risque-de-vous-surprendre.htm <nowiki>[WEBM] il tente le BAH SORS, la suite risque de vous surprendre</nowiki>]


=== Balise [VIDÉO] ===
À défaut de comporter la balise WEBM (cependant largement majoritaire pour les topics de ce genre), certains intitulés comportent la mention "vidéo", ce qui arrive généralement lorsque l'OP est un [[newfag]] ne connaissant pas encore bien les codes du forum ou lorsque la vidéo partagée n'est pas un WEBM à proprement parler.

=== Sélection naturelle ===
Le terme de [[sélection naturelle]] est très apprécié lorsqu'il s'agit d'intituler des WEBM filmant des accidents ou témoignant de l'incompétence de certains individus qui entraînera de graves conséquences. On retrouve des variantes toujours plus nombreuses de l'expression, telles que : ''la sélection fut 100% naturelle'', ''la nature prend le dossier en charge'', ''la nature n'est pas de cet avis'', etc. En voici deux exemples : 
[https://jvarchive.com/forums/42-51-71409556-1-0-1-0-webm-un-malien-tente-un-plongeon-a-st-barth-la-nature-soccupe-du-dossier <nowiki> [WEBM] Un MALIEN tente un PLONGEON à ST-BARTH, la NATURE s'occupe du DOSSIER</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71435766-1-0-1-0-webm-un-petit-moment-d-inattention-sur-la-route-la-selection-ne-se-fait-pas-attendre.htm <nowiki>[WEBM] Un petit MOMENT d'INATTENTION sur la ROUTE, la SÉLECTION ne se fait PAS ATTENDRE</nowiki>]

== Réaction de la [[modération]] ==
=== Avant mai 2024 ===
Il n'y a officiellement pas de réglementation à propos des WEBM sur les forums.<ref>https://www.jeuxvideo.com/forums/message/1180766811</ref> Cependant, leur partage n'est généralement pas très apprécié par la modération du fait qu'ils peuvent rapidement conduire à la diffusion de vidéos hors-charte.
Ainsi, les topics WEBM sont la plupart du temps supprimés après une durée relativement courte surtout lorsque les vidéos qu'ils incluent ne respectent par la [[charte]] et remplissent le motif ''Image ou vidéo choquante, gore'', malgré le grand nombre de forumeurs qui apprécient ces topics.

=== Mai 2024 ===
Le 28 mai 2024, les forumeurs remarquent que les posts contenant des liens redirigeant vers du contenu hébergé sur [https://streamable.com Streamable], [https://webmshare.com webmshare] et [https://issoutv.com IssouTV] sont automatiquement supprimés<ref>https://www.jeuxvideo.com/forums/42-51-74327261-1-0-1-0-censure-les-videos-streamable-desormais-auto-supprimee-sur-le-forom.htm</ref>, ce qui provoque colère et dépit. [https://webm.red webm.red] et [https://www.risishack.com/ RisiShack] sont cependant épargnés. Les [[administrateur|administrateurs]] de jeuxvideo.com se justifient de la manière suivante :
{{BoxCitation|Citation=Les vidéos hébergées sur ces plateformes diffusent du contenu qui ne respecte pas la charte du forum et demandent une bande passante conséquente de modération. Par conséquent ces dernières sont interdites.<ref>https://image.noelshack.com/fichiers/2024/22/2/1716915626-screnn5874456.png</ref>|Auteur=Service réclamations de jeuxvideo.com}}

Finalement, une journée après, les liens redirigeant vers les deux plateformes semblent de ne plus être censurés après un assouplissement de la restriction.

{{SectionRéférences}}
{{Article de qualité}}
[[Catégorie:Article de qualité]]
[[Catégorie:Vocabulaire externe]]

WEBM

2024-07-09T16:28:17Z

HelloWorld5000 : Ajout de catbox.moe

[[File:WebM_logo.png|vignette|250px|Le logotype officiel du format WebM.]]

'''WEBM''' (stylisé ''WebM'') est un format de fichier vidéo principalement destiné à être utilisé sur le Web. Ce terme est par extension utilisé par le [[Blabla 18-25 ans|18-25]] pour qualifier les vidéos que se partagent les [[forumeur|forumeurs]] entre eux. Les WEBM sont généralement appréciés, si bien que certains forumeurs se sont spécialisés dans ce domaine. Les topics comportant en titre une balise ''[WEBM]'' indiquent qu'ils contiennent une telle vidéo.

= Contenu =
== Dénomination ==
Bien que WEBM désigne à l'origine un format de fichier vidéo spécifique, on nomme habituellement ''WEBM'' toute vidéo partagée entre [[forumeurs]], hébergée et relayée sur un service Web prévu à cet effet (voir [[WEBM#Plateformes d'hébergement et de relais|la section attitrée de cet article]]), avec comme seul intérêt la vidéo en elle-même. Une faible minorité de forumeurs puristes prône l'utilisation de ce terme exclusivement concernant les fichiers portant cette extension<ref>https://www.jeuxvideo.com/forums/message/1214151400</ref>. 
Les vidéos présentes sur les réseaux sociaux, YouTube ou toute autre plateforme très modérée ne sont quant à eux habituellement pas vus comme des WEBM car ce style de contenu est souvent éloigné de ce qu'aiment se partager les forumeurs (voir [[WEBM#Nature des WEBM|la section suivante]] pour plus de détails).
== Nature des WEBM ==
Les WEBM partagés par les forumeurs ont principalement pour but de faire rire ou de surprendre. La plupart du temps, les WEBM mettent en scène des vidéos insolites ou à caractère humoristique. Loin d'êtres niais et gentillets, les WEBM partagés par les forumeurs se révèlent souvent trash voire très explicites.

Plus précisément, il peut s'agir d'accidents routiers, de chutes, d'incidents matériels ou industriels impliquant directement des humains ou non, de scènes de violence relativement légères et rarement gores, ou de nudité, mais également de redpills sur les relations sociales, de contenus glissants etc.

Ceci dit, une partie non-négligeable des WEBM partagés ont un objectif purement humoristique, souvent par leur attrait, contenu ou intitulé absurde.

=== Chine ===
Certains types spéciaux de WEBM ont émergé, par exemple sur la Chine où le but principal des WEBM partagés (réservés à un public averti) est de montrer des accidents du travail ou accidents industriels récurrents en Chine, ainsi que le manque apparent d'empathie qu'éprouvent les Chinois envers leurs compatriotes lorsqu'ils sont victimes d'accidents routiers, en les laissant pour morts, ou encore le décalage qu'il peut y avoir entre les sociétés européennes et asiatiques.<ref>https://www.jeuxvideo.com/forums/42-51-60397834-1-0-1-0-putain-les-webm-du-pave-chine.htm</ref>
On retrouve la plupart de ces WEBM dans le [[Pavé Chine|pavé Chine]].

=== Pneus tueurs ===
Cette appellation est réservée aux WEBM filmant des scènes de pneus qui lorsqu'ils se décrochent de leur châssis peuvent causer de gros dégâts humains ou matériels. Une [[boucle]] est alimentée par le forumeur ''PneuTueur'' à ce sujet <ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=pneus%20tueurs</ref>. Il semble que l'expression ait été pour la première fois utilisée sur [https://www.jeuxvideo.com/forums/42-51-70854977-1-0-1-0-webm-les-pneus-tueurs-uniquement-en-chine-etonnant.htm ce topic], et a été largement popularisée depuis lors.

=== WEBM du malaise ===
{{Article connexe|Malaisologie}}
[[File:webm-malaise.png|vignette|200px|Le topic ''WEBM du malaise'' du nouvel an 2023.]]
Certains WEBM se distinguent des autres par leur capacité à provoquer un malaise considérable chez les forumeurs : il s'agit des WEBM dits « du malaise », mettant souvent en scène des personnages archétypaux du [[french dream]] (comme des [[Magalie]]) ou des ''cas sociaux'' de TikTok.<ref>https://www.jeuxvideo.com/forums/42-51-71308627-1-0-1-0-boucle-cest-lheure-des-webm-du-malaise.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71498712-1-0-1-0-soiree-nouvel-an-webm-la-compilation-ultime-des-webm-du-malaise.htm</ref> C'est par exemple le cas de la vidéo [[Et Tic et Tac hein hein|''et tic et tac hein hein'']].

== Plateformes d'hébergement et de relais ==
Les plateformes d'hébergement sont les services Web qui hébergent les WEBM dont les forumeurs se partagent les liens. Souvent, ce sont ces derniers qui ajoutent eux-mêmes la vidéo sur une plateforme telle que Streamable ou webmshare, mais il se peut également qu'ils partagent le lien "brut" amenant à la vidéo originelle (liens [[4chan]], Reddit, etc.). 
Les plateformes d'hébergement/relais de WEBM les plus utilisées par les forumeurs sont (par ordre approximatif de popularité) :
* [https://streamable.com Streamable]
* [https://webmshare.com webmshare]
* [https://4chan.org 4chan] (notamment le board ''/gif/'')
* [https://issoutv.com/ IssouTV]
* [https://webm.red/ webm.red]
* [https://catbox.moe/ catbox.moe]
* [https://orbitum.space/ orbitum.space]
* [https://www.risishack.com/ RisiShack]
* [https://www.reddit.com Reddit] (notamment les subreddits ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'').

Stremable et webmshare sont les plateformes les plus populaires sur le forum. Streamable a l'avantage de prendre en charge la majorité des formats vidéo (dont WEBM et MP4) mais ne permet pas de télécharger nativement du contenu, contrairement à webmshare qui n'héberge que les fichiers WEBM et autorise le téléchargement de vidéos. Les contenus choquants ou illégaux sont occasionnellement supprimés sur Streamable, et leur auteur banni, ce qui n'arrive visiblement jamais sur webmshare : il semble que ce soit la plateforme la plus stable. De plus, il est nécessaire de créer un compte sur Streamable afin que les vidéos uploadées y soit conservées plus d'un jour, tandis que webmshare peut être utilisée en tant qu'invité. Le contenu hébergé sur webmshare ne peut être lu sur iPhone<ref>https://www.jeuxvideo.com/forums/42-51-70753532-1-0-1-0-tu-as-l-iphone-14-oui-je-ne-peux-pas-lire-les-webm.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71211520-1-0-1-0-j-arrive-pas-a-lire-les-webm-sur-mon-iphone-13.htm</ref>. Les deux demeurent (septembre 2023) largement en tête quant au nombre de vidéos partagées sur le forum. 
IssouTV a été comme son nom l'indique spécialement créé pour les utilisateurs de [[jeuxvideo.com|JVC]] et demeure assez utilisé. 
Le board ''/gif/'' de [[4chan]] contient un grand nombre de vidéos pornographiques mais également du contenu trash et gore. Très souvent, les contenus hébergés sur le ''/gif/'' de 4chan sont supprimés quelques semaines voire mois après ; on ignore s'il s'agit de l'action d'administrateurs ou d'un système automatique. Ainsi, les liens 4chan des anciens topics ne redirigent souvent que vers une erreur 404. Il est donc plutôt recommandé de télécharger le contenu hébergé sur 4chan et de le déposer sur une plateforme plus fiable. 
webm.red est une alternative à webmshare peu utilisée mais qui présente à peu près les mêmes fonctionnalités (prise en charge du format WEBM seulement, possibilité de télécharger les vidéos, etc.). 
catbox.moe est une plateforme acceptant toutes les extensions jusqu'à 200 Mo, ce qui fait qu'il n'est pas rare de voir des liens dirigeant vers celle-ci sur le forum. Elle semble également peu modérée.
Les threads Reddit ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'' contiennent quant à eux du contenu relativement trash.
La plateforme décentralisée ''orbitum.space'', gérée par des [[forumeurs]], accueille parfois des vidéos censurées sur ''jeuxvideo.com'' ; RisiShack, très peu utilisé, héberge des fichiers MP4.

Il est à noter que les topics comportant un lien YouTube, Twitter ou TikTok portent généralement une balise ''[WEBM]'' bien qu'ils ne puissent être considérés comme tel au sens strict. Certains forumeurs puristes ne manquent pas de le faire remarquer.<ref>https://jvarchive.com/forums/42-51-71462933-1-0-1-0-webm-ce-boule-va-vous-rendre-maboule</ref>

=== Anciennes plateformes d'hébergement ===
Il semble que d'autres plateformes aient été relativement populaires dans le passé ; c'est notamment le cas de ''webm.land'' et de ''yuki.la''.<ref>https://www.jeuxvideo.com/forums/42-51-55865982-1-0-1-0-webm-no-trash-hun-j-veux-pas-de-410-moi-svp.htm</ref> Ces services Web sont aujourd'hui fermés et inaccessibles. Il en est de même pour le contenu qui avait été hébergé dessus.

=== Script ===
Un [[script|userscript]] ''StreamableDownloader'' a été développé par un membre du forum pour permettre aux utilisateurs de télécharger les vidéos hébergées sur [https://streamable.com Streamable], voir [https://greasyfork.org/fr/scripts/453105-streamabledownloader la page d'accueil du script].

=== WEBM originaux ===
La plupart du temps les WEBM sont relayés sur les plateformes précédemment citées, mais les originaux sont souvent trouvés sur des sites trashs/gores tels que WebChoc, Bestgore, Kaotic, et auparavant LeakReality avant qu'il ne soit supprimé. Les liens vers ces plateformes sont cependant très rares afin de minimiser le risque de censure, et les forumeurs préfèrent uploader le contenu en question sur une des plateformes précédemment citées.
Certains WEBM proviennent directement de TikTok mais semblent être beaucoup moins appréciés par la communauté du fait de leur contenu jugé souvent peu intéressant et de la désapprobation générale de ce réseau social par le forum. On peut également retrouver des WEBM hébergés à l'origine sur YouTube ou Twitter. Ces trois derniers étant plus strictement modérés, ce sont souvent des WEBM softs qui découlent de là-bas. De ce fait, on leur préfère la balise ''[VIDÉO]'' (voir [[#Balise_VIDÉO|la sous-partie éponyme de cet article]]).

= Topics WEBM =
Les [[topic|topics]] WEBM sont très courants et très populaires sur le [[Blabla 18-25 ans|18-25]], mais demeurent trouvables presque exclusivement sur ce forum. On y compte environ une vingtaine de nouveaux topics WEBM par jour<ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=webm</ref>.

== Types de topics WEBM ==
On distingue deux types de topics WEBM :
* Des topics à "WEBM unique" ayant pour but de présenter un seul WEBM, dont le lien est présent dans le premier message de l'[[OP]]. 
[https://www.jeuxvideo.com/forums/42-51-71425835-1-0-1-0-webm-il-crie-woop-woop-puis-fait-une-prise-de-catch-a-son-micro-ondes-et-devient-tetraplegique.htm <nowiki>[WEBM] Il crie « WOOP WOOP » puis FAIT une PRISE de CATCH à son MICRO-ONDES et devient TÉTRAPLÉGIQUE</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70627502-1-0-1-0-webm-il-colle-une-voiture-sur-l-autoroute-la-selection-fut-naturelle.htm <nowiki>[WEBM] Il colle une VOITURE sur l'AUTOROUTE, la sélection fut NATURELLE</nowiki>]
* Ainsi que des topics "compilation" où l'auteur poste en continue des WEBM pendant plusieurs minutes ou dizaines de minutes (dépendant de la quantité de WEBM dont l'[[OP]] est en possession, de la réception du topic par les autres forumeurs, et surtout de la réaction de la [[modération]]). 
[https://www.jeuxvideo.com/forums/42-51-71421226-1-0-1-0-webm-ils-jouent-a-biere-pong-un-pere-noel-apparait-et-se-casse-le-coccyx.htm <nowiki>[WEBM] Ils jouent à BIÈRE-PONG, un PÈRE NOËL APPARAÎT et se CASSE le COCCYX</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71450605-1-0-1-0-webm-il-evite-de-justesse-sa-tronconneuse-se-remet-en-question.htm <nowiki>[WEBM] Il évite de justesse sa TRONÇONNEUSE, se REMET en QUESTION</nowiki>] 

Bien que les topics à WEBM unique soient les plus courants sur le forum, les topics de compilation sont généralement très appréciés par la planète forum : ils montent facilement à plusieurs centaines de connectés et à une dizaine de pages. Il arrive souvent que d'autres amateurs de WEBM y rejoignent l'auteur pour poster leurs vidéos.

=== Topics [[fake|fakes]] ===
Certains topics [[troll|trolls]] annoncent dans leur titre une vidéo imaginaire à l'intitulé très aguicheur et insolite, où le premier message est parfois accompagnés de la mention [[post ou cancer]] ou ses dérivés, ''pourquoi as-tu cliqué ?'', ''"cette vidéo n'existe pas'', ''j'aimerais bien voir ça'', simplement dans le but d'attirer des connectés sur le topic. S'ensuit alors des réponses ironiques de type ''pour voir la vidéo'' ou encore ''t'as oublié le lien''. En voici deux exemples : 
[https://www.jeuxvideo.com/forums/42-51-71421330-1-0-1-0-webm-il-plante-une-hache-sur-un-cheval-qui-le-catapulte-dans-le-composte.htm <nowiki>[Webm] Il plante une hache sur un cheval qui le catapulte dans le composte</nowiki>]. 
[https://www.jeuxvideo.com/forums/42-51-71450141-1-0-1-0-webm-cette-japonaise-chie-une-buche-de-noel-dans-l-assiette-de-son-copain.htm <nowiki>[WEBM] Cette JAPONAISE CHIE une bûche de noël dans l'assiette de son COPAIN</nowiki>]. 

Il est évident que ces topics sont très peu appréciés et souvent [[DDB]] en masse, puisqu'ils occasionnent une déception chez les forumeurs ayant cliqué.

=== Certification de [[nofake]] et [[éclaireur]] ===
[[Fichier:nofake sticker.png|vignette|200px|Le fameux sticker nofake étant généralement admis comme preuve incontestable d'un nofake.]]

Parallèlement aux topics fake, la certification de [[nofake]], réalisée par un forumeur autre que l'auteur, est un moyen pour ceux qui ont cliqué sur le topic de savoir si le titre est en bonne adéquation avec le contenu de la vidéo présentée. Ces certifications, qui permettent à la fois de faire gage de qualité et d'[[up]] le topic concerné, sont parfois demandées par l'[[OP]] dans son post pour démontrer la véracité du titre aussi invraisemblable soit-il. 
On note diverses déclinaisons de cette certification, telles que : [[le titre est malheureusement nofake|''Le titre est malheureusement nofake'']], ''Je certifie que le titre de l'annotateur principal de ce fil de discussion est en total adéquation avec le contenu du présent court-métrage présenté sur cette page HTML sur laquelle vous naviguez actuellement.'', etc. 
L'[[éclaireur]], quant à lui, est parfois demandé sur les topics WEBM par un forumeur réticent à l'idée de cliquer sur le lien partagé par l'auteur à cause d'un titre de topic douteux, de peur de tomber sur un screamer ou du contenu gore, choquant. Les éclaireurs ont ainsi pour mission de vérifier la vidéo et de signaler si cette dernière est ''safe'' ou non. L'éclaireur peut dans la foulée réaliser la certification de nofake.

== Titres ==
Les titres de topics WEBM sont souvent aguicheurs et insolites ; ils caricaturent les contenus ''putaclicks'' d'Internet en reprenant leurs éléments de langage. Parmi ces derniers, nous pouvons citer entre autres : ''la suite risque de vous surprendre'', ''ça tourne mal'', ''sa réaction est étonnante'', etc. 
[https://www.jeuxvideo.com/forums/42-51-71483319-1-0-1-0-webm-il-dort-dans-son-lit-se-mange-une-branche-sa-pasteque-tombe-dans-l-eau.htm <nowiki> [WEBM] Il dort dans son lit, se mange une branche, sa pastèque tombe dans l'eau </nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70167283-1-0-1-0-webm-il-tente-le-bah-sort-la-suite-risque-de-vous-surprendre.htm <nowiki>[WEBM] il tente le BAH SORS, la suite risque de vous surprendre</nowiki>]


=== Balise [VIDÉO] ===
À défaut de comporter la balise WEBM (cependant largement majoritaire pour les topics de ce genre), certains intitulés comportent la mention "vidéo", ce qui arrive généralement lorsque l'OP est un [[newfag]] ne connaissant pas encore bien les codes du forum ou lorsque la vidéo partagée n'est pas un WEBM à proprement parler.

=== Sélection naturelle ===
Le terme de [[sélection naturelle]] est très apprécié lorsqu'il s'agit d'intituler des WEBM filmant des accidents ou témoignant de l'incompétence de certains individus qui entraînera de graves conséquences. On retrouve des variantes toujours plus nombreuses de l'expression, telles que : ''la sélection fut 100% naturelle'', ''la nature prend le dossier en charge'', ''la nature n'est pas de cet avis'', etc. En voici deux exemples : 
[https://jvarchive.com/forums/42-51-71409556-1-0-1-0-webm-un-malien-tente-un-plongeon-a-st-barth-la-nature-soccupe-du-dossier <nowiki> [WEBM] Un MALIEN tente un PLONGEON à ST-BARTH, la NATURE s'occupe du DOSSIER</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71435766-1-0-1-0-webm-un-petit-moment-d-inattention-sur-la-route-la-selection-ne-se-fait-pas-attendre.htm <nowiki>[WEBM] Un petit MOMENT d'INATTENTION sur la ROUTE, la SÉLECTION ne se fait PAS ATTENDRE</nowiki>]

== Réaction de la [[modération]] ==
=== Avant mai 2024 ===
Il n'y a officiellement pas de réglementation à propos des WEBM sur les forums.<ref>https://www.jeuxvideo.com/forums/message/1180766811</ref> Cependant, leur partage n'est généralement pas très apprécié par la modération du fait qu'ils peuvent rapidement conduire à la diffusion de vidéos hors-charte.
Ainsi, les topics WEBM sont la plupart du temps supprimés après une durée relativement courte surtout lorsque les vidéos qu'ils incluent ne respectent par la [[charte]] et remplissent le motif ''Image ou vidéo choquante, gore'', malgré le grand nombre de forumeurs qui apprécient ces topics.

=== Mai 2024 ===
Le 28 mai 2024, les forumeurs remarquent que les posts contenant des liens redirigeant vers du contenu hébergé sur [https://streamable.com Streamable], [https://webmshare.com webmshare] et [https://issoutv.com IssouTV] sont automatiquement supprimés<ref>https://www.jeuxvideo.com/forums/42-51-74327261-1-0-1-0-censure-les-videos-streamable-desormais-auto-supprimee-sur-le-forom.htm</ref>, ce qui provoque colère et dépit. [https://webm.red webm.red] et [https://www.risishack.com/ RisiShack] sont cependant épargnés. Les [[administrateur|administrateurs]] de jeuxvideo.com se justifient de la manière suivante :
{{BoxCitation|Citation=Les vidéos hébergées sur ces plateformes diffusent du contenu qui ne respecte pas la charte du forum et demandent une bande passante conséquente de modération. Par conséquent ces dernières sont interdites.<ref>https://image.noelshack.com/fichiers/2024/22/2/1716915626-screnn5874456.png</ref>|Auteur=Service réclamations de jeuxvideo.com}}

Finalement, une journée après, les liens redirigeant vers les deux plateformes semblent de ne plus être censurés après un assouplissement de la restriction.

{{SectionRéférences}}
{{Article de qualité}}
[[Catégorie:Article de qualité]]
[[Catégorie:Vocabulaire externe]]

WEBM

2024-05-28T18:15:33Z

HelloWorld5000 : /* À partir de mai 2024 */

[[File:WebM_logo.png|vignette|250px|Le logotype officiel du format WebM.]]

'''WEBM''' (stylisé ''WebM'') est un format de fichier vidéo principalement destiné à être utilisé sur le Web. Ce terme est par extension utilisé par le [[Blabla 18-25 ans|18-25]] pour qualifier les vidéos que se partagent les [[forumeur|forumeurs]] entre eux. Les WEBM sont généralement appréciés, si bien que certains forumeurs se sont spécialisés dans ce domaine. Les topics comportant en titre une balise ''[WEBM]'' indiquent qu'ils contiennent une telle vidéo.

= Contenu =
== Dénomination ==
Bien que WEBM désigne à l'origine un format de fichier vidéo spécifique, on nomme habituellement ''WEBM'' toute vidéo partagée entre [[forumeurs]], hébergée et relayée sur un service Web prévu à cet effet (voir [[WEBM#Plateformes d'hébergement et de relais|la section attitrée de cet article]]), avec comme seul intérêt la vidéo en elle-même. Une faible minorité de forumeurs puristes prône l'utilisation de ce terme exclusivement concernant les fichiers portant cette extension<ref>https://www.jeuxvideo.com/forums/message/1214151400</ref>. 
Les vidéos présentes sur les réseaux sociaux, YouTube ou toute autre plateforme très modérée ne sont quant à eux habituellement pas vus comme des WEBM car ce style de contenu est souvent éloigné de ce qu'aiment se partager les forumeurs (voir [[WEBM#Nature des WEBM|la section suivante]] pour plus de détails).
== Nature des WEBM ==
Les WEBM partagés par les forumeurs ont principalement pour but de faire rire ou de surprendre. La plupart du temps, les WEBM mettent en scène des vidéos insolites ou à caractère humoristique. Loin d'êtres niais et gentillets, les WEBM partagés par les forumeurs se révèlent souvent trash voire très explicites.

Plus précisément, il peut s'agir d'accidents routiers, de chutes, d'incidents matériels ou industriels impliquant directement des humains ou non, de scènes de violence relativement légères et rarement gores, ou de nudité, mais également de redpills sur les relations sociales, de contenus glissants etc.

Ceci dit, une partie non-négligeable des WEBM partagés ont un objectif purement humoristique, souvent par leur attrait, contenu ou intitulé absurde.

=== Chine ===
Certains types spéciaux de WEBM ont émergé, par exemple sur la Chine où le but principal des WEBM partagés (réservés à un public averti) est de montrer des accidents du travail ou accidents industriels récurrents en Chine, ainsi que le manque apparent d'empathie qu'éprouvent les Chinois envers leurs compatriotes lorsqu'ils sont victimes d'accidents routiers, en les laissant pour morts, ou encore le décalage qu'il peut y avoir entre les sociétés européennes et asiatiques.<ref>https://www.jeuxvideo.com/forums/42-51-60397834-1-0-1-0-putain-les-webm-du-pave-chine.htm</ref>
On retrouve la plupart de ces WEBM dans le [[Pavé Chine|pavé Chine]].

=== Pneus tueurs ===
Cette appellation est réservée aux WEBM filmant des scènes de pneus qui lorsqu'ils se décrochent de leur châssis peuvent causer de gros dégâts humains ou matériels. Une [[boucle]] est alimentée par le forumeur ''PneuTueur'' à ce sujet <ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=pneus%20tueurs</ref>. Il semble que l'expression ait été pour la première fois utilisée sur [https://www.jeuxvideo.com/forums/42-51-70854977-1-0-1-0-webm-les-pneus-tueurs-uniquement-en-chine-etonnant.htm ce topic], et a été largement popularisée depuis lors.

=== WEBM du malaise ===
{{Article connexe|Malaisologie}}
[[File:webm-malaise.png|vignette|200px|Le topic ''WEBM du malaise'' du nouvel an 2023.]]
Certains WEBM se distinguent des autres par leur capacité à provoquer un malaise considérable chez les forumeurs : il s'agit des WEBM dits « du malaise », mettant souvent en scène des personnages archétypaux du [[french dream]] (comme des [[Magalie]]) ou des ''cas sociaux'' de TikTok.<ref>https://www.jeuxvideo.com/forums/42-51-71308627-1-0-1-0-boucle-cest-lheure-des-webm-du-malaise.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71498712-1-0-1-0-soiree-nouvel-an-webm-la-compilation-ultime-des-webm-du-malaise.htm</ref> C'est par exemple le cas de la vidéo [[Et Tic et Tac hein hein|''et tic et tac hein hein'']].

== Plateformes d'hébergement et de relais ==
Les plateformes d'hébergement sont les services Web qui hébergent les WEBM dont les forumeurs se partagent les liens. Souvent, ce sont ces derniers qui ajoutent eux-mêmes la vidéo sur une plateforme telle que Streamable ou webmshare, mais il se peut également qu'ils partagent le lien "brut" amenant à la vidéo originelle (liens [[4chan]], Reddit, etc.). 
Les plateformes d'hébergement/relais de WEBM les plus utilisées par les forumeurs sont (par ordre approximatif de popularité) :
* [https://streamable.com Streamable]
* [https://webmshare.com webmshare]
* [https://4chan.org 4chan] (notamment le board ''/gif/'')
* [https://issoutv.com/ IssouTV]
* [https://webm.red/ webm.red]
* [https://www.reddit.com Reddit] (notamment les subreddits ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'')
* [https://orbitum.space/ orbitum.space]
* [https://www.risishack.com/ RisiShack].

Stremable et webmshare sont les plateformes les plus populaires sur le forum. Streamable a l'avantage de prendre en charge la majorité des formats vidéo (dont WEBM et MP4) mais ne permet pas de télécharger nativement du contenu, contrairement à webmshare qui n'héberge que les fichiers WEBM et autorise le téléchargement de vidéos. Les contenus choquants ou illégaux sont occasionnellement supprimés sur Streamable, et leur auteur banni, ce qui n'arrive visiblement jamais sur webmshare : il semble que ce soit la plateforme la plus stable. De plus, il est nécessaire de créer un compte sur Streamable afin que les vidéos uploadées y soit conservées plus d'un jour, tandis que webmshare peut être utilisée en tant qu'invité. Le contenu hébergé sur webmshare ne peut être lu sur iPhone<ref>https://www.jeuxvideo.com/forums/42-51-70753532-1-0-1-0-tu-as-l-iphone-14-oui-je-ne-peux-pas-lire-les-webm.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71211520-1-0-1-0-j-arrive-pas-a-lire-les-webm-sur-mon-iphone-13.htm</ref>. Les deux demeurent (septembre 2023) largement en tête quant au nombre de vidéos partagées sur le forum. 
IssouTV a été comme son nom l'indique spécialement créé pour les utilisateurs de [[jeuxvideo.com|JVC]] et demeure assez utilisé. 
Le board ''/gif/'' de [[4chan]] contient un grand nombre de vidéos pornographiques mais également du contenu trash et gore. Très souvent, les contenus hébergés sur le ''/gif/'' de 4chan sont supprimés quelques semaines voire mois après ; on ignore s'il s'agit de l'action d'administrateurs ou d'un système automatique. Ainsi, les liens 4chan des anciens topics ne redirigent souvent que vers une erreur 404. Il est donc plutôt recommandé de télécharger le contenu hébergé sur 4chan et de le déposer sur une plateforme plus fiable. 
webm.red est une alternative à webmshare peu utilisée mais qui présente à peu près les mêmes fonctionnalités (prise en charge du format WEBM seulement, possibilité de télécharger les vidéos, etc.). 
Les threads Reddit ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'' contiennent quant à eux du contenu relativement trash.
La plateforme décentralisée ''orbitum.space'', gérée par des [[forumeurs]], accueille parfois des vidéos censurées sur ''jeuxvideo.com'' ; RisiShack, très peu utilisé, héberge des fichiers MP4.

Il est à noter que les topics comportant un lien YouTube, Twitter ou TikTok portent généralement une balise ''[WEBM]'' bien qu'ils ne puissent être considérés comme tel au sens strict. Certains forumeurs puristes ne manquent pas de le faire remarquer.<ref>https://jvarchive.com/forums/42-51-71462933-1-0-1-0-webm-ce-boule-va-vous-rendre-maboule</ref>

=== Anciennes plateformes d'hébergement ===
Il semble que d'autres plateformes aient été relativement populaires dans le passé ; c'est notamment le cas de ''webm.land'' et de ''yuki.la''.<ref>https://www.jeuxvideo.com/forums/42-51-55865982-1-0-1-0-webm-no-trash-hun-j-veux-pas-de-410-moi-svp.htm</ref> Ces services Web sont aujourd'hui fermés et inaccessibles. Il en est de même pour le contenu qui avait été hébergé dessus.

=== Script ===
Un [[script|userscript]] ''StreamableDownloader'' a été développé par un membre du forum pour permettre aux utilisateurs de télécharger les vidéos hébergées sur [https://streamable.com Streamable], voir [https://greasyfork.org/fr/scripts/453105-streamabledownloader la page d'accueil du script].

=== WEBM originaux ===
La plupart du temps les WEBM sont relayés sur les plateformes précédemment citées, mais les originaux sont souvent trouvés sur des sites trashs/gores tels que WebChoc, Bestgore, Kaotic, et auparavant LeakReality avant qu'il ne soit supprimé. Les liens vers ces plateformes sont cependant très rares afin de minimiser le risque de censure, et les forumeurs préfèrent uploader le contenu en question sur une des plateformes précédemment citées.
Certains WEBM proviennent directement de TikTok mais semblent être beaucoup moins appréciés par la communauté du fait de leur contenu jugé souvent peu intéressant et de la désapprobation générale de ce réseau social par le forum. On peut également retrouver des WEBM hébergés à l'origine sur YouTube ou Twitter. Ces trois derniers étant plus strictement modérés, ce sont souvent des WEBM softs qui découlent de là-bas. De ce fait, on leur préfère la balise ''[VIDÉO]'' (voir [[#Balise_VIDÉO|la sous-partie éponyme de cet article]]).

= Topics WEBM =
Les [[topic|topics]] WEBM sont très courants et très populaires sur le [[Blabla 18-25 ans|18-25]], mais demeurent trouvables presque exclusivement sur ce forum. On y compte environ une vingtaine de nouveaux topics WEBM par jour<ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=webm</ref>.

== Types de topics WEBM ==
On distingue deux types de topics WEBM :
* Des topics à "WEBM unique" ayant pour but de présenter un seul WEBM, dont le lien est présent dans le premier message de l'[[OP]]. 
[https://www.jeuxvideo.com/forums/42-51-71425835-1-0-1-0-webm-il-crie-woop-woop-puis-fait-une-prise-de-catch-a-son-micro-ondes-et-devient-tetraplegique.htm <nowiki>[WEBM] Il crie « WOOP WOOP » puis FAIT une PRISE de CATCH à son MICRO-ONDES et devient TÉTRAPLÉGIQUE</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70627502-1-0-1-0-webm-il-colle-une-voiture-sur-l-autoroute-la-selection-fut-naturelle.htm <nowiki>[WEBM] Il colle une VOITURE sur l'AUTOROUTE, la sélection fut NATURELLE</nowiki>]
* Ainsi que des topics "compilation" où l'auteur poste en continue des WEBM pendant plusieurs minutes ou dizaines de minutes (dépendant de la quantité de WEBM dont l'[[OP]] est en possession, de la réception du topic par les autres forumeurs, et surtout de la réaction de la [[modération]]). 
[https://www.jeuxvideo.com/forums/42-51-71421226-1-0-1-0-webm-ils-jouent-a-biere-pong-un-pere-noel-apparait-et-se-casse-le-coccyx.htm <nowiki>[WEBM] Ils jouent à BIÈRE-PONG, un PÈRE NOËL APPARAÎT et se CASSE le COCCYX</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71450605-1-0-1-0-webm-il-evite-de-justesse-sa-tronconneuse-se-remet-en-question.htm <nowiki>[WEBM] Il évite de justesse sa TRONÇONNEUSE, se REMET en QUESTION</nowiki>] 

Bien que les topics à WEBM unique soient les plus courants sur le forum, les topics de compilation sont généralement très appréciés par la planète forum : ils montent facilement à plusieurs centaines de connectés et à une dizaine de pages. Il arrive souvent que d'autres amateurs de WEBM y rejoignent l'auteur pour poster leurs vidéos.

=== Topics [[fake|fakes]] ===
Certains topics [[troll|trolls]] annoncent dans leur titre une vidéo imaginaire à l'intitulé très aguicheur et insolite, où le premier message est parfois accompagnés de la mention [[post ou cancer]] ou ses dérivés, ''pourquoi as-tu cliqué ?'', ''"cette vidéo n'existe pas'', ''j'aimerais bien voir ça'', simplement dans le but d'attirer des connectés sur le topic. S'ensuit alors des réponses ironiques de type ''pour voir la vidéo'' ou encore ''t'as oublié le lien''. En voici deux exemples : 
[https://www.jeuxvideo.com/forums/42-51-71421330-1-0-1-0-webm-il-plante-une-hache-sur-un-cheval-qui-le-catapulte-dans-le-composte.htm <nowiki>[Webm] Il plante une hache sur un cheval qui le catapulte dans le composte</nowiki>]. 
[https://www.jeuxvideo.com/forums/42-51-71450141-1-0-1-0-webm-cette-japonaise-chie-une-buche-de-noel-dans-l-assiette-de-son-copain.htm <nowiki>[WEBM] Cette JAPONAISE CHIE une bûche de noël dans l'assiette de son COPAIN</nowiki>]. 

Il est évident que ces topics sont très peu appréciés et souvent [[DDB]] en masse, puisqu'ils occasionnent une déception chez les forumeurs ayant cliqué.

=== Certification de [[nofake]] et [[éclaireur]] ===
[[Fichier:nofake sticker.png|vignette|200px|Le fameux sticker nofake étant généralement admis comme preuve incontestable d'un nofake.]]

Parallèlement aux topics fake, la certification de [[nofake]], réalisée par un forumeur autre que l'auteur, est un moyen pour ceux qui ont cliqué sur le topic de savoir si le titre est en bonne adéquation avec le contenu de la vidéo présentée. Ces certifications, qui permettent à la fois de faire gage de qualité et d'[[up]] le topic concerné, sont parfois demandées par l'[[OP]] dans son post pour démontrer la véracité du titre aussi invraisemblable soit-il. 
On note diverses déclinaisons de cette certification, telles que : [[le titre est malheureusement nofake|''Le titre est malheureusement nofake'']], ''Je certifie que le titre de l'annotateur principal de ce fil de discussion est en total adéquation avec le contenu du présent court-métrage présenté sur cette page HTML sur laquelle vous naviguez actuellement.'', etc. 
L'[[éclaireur]], quant à lui, est parfois demandé sur les topics WEBM par un forumeur réticent à l'idée de cliquer sur le lien partagé par l'auteur à cause d'un titre de topic douteux, de peur de tomber sur un screamer ou du contenu gore, choquant. Les éclaireurs ont ainsi pour mission de vérifier la vidéo et de signaler si cette dernière est ''safe'' ou non. L'éclaireur peut dans la foulée réaliser la certification de nofake.

== Titres ==
Les titres de topics WEBM sont souvent aguicheurs et insolites ; ils caricaturent les contenus ''putaclicks'' d'Internet en reprenant leurs éléments de langage. Parmi ces derniers, nous pouvons citer entre autres : ''la suite risque de vous surprendre'', ''ça tourne mal'', ''sa réaction est étonnante'', etc. 
[https://www.jeuxvideo.com/forums/42-51-71483319-1-0-1-0-webm-il-dort-dans-son-lit-se-mange-une-branche-sa-pasteque-tombe-dans-l-eau.htm <nowiki> [WEBM] Il dort dans son lit, se mange une branche, sa pastèque tombe dans l'eau </nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70167283-1-0-1-0-webm-il-tente-le-bah-sort-la-suite-risque-de-vous-surprendre.htm <nowiki>[WEBM] il tente le BAH SORS, la suite risque de vous surprendre</nowiki>]


=== Balise [VIDÉO] ===
À défaut de comporter la balise WEBM (cependant largement majoritaire pour les topics de ce genre), certains intitulés comportent la mention "vidéo", ce qui arrive généralement lorsque l'OP est un [[newfag]] ne connaissant pas encore bien les codes du forum ou lorsque la vidéo partagée n'est pas un WEBM à proprement parler.

=== Sélection naturelle ===
Le terme de [[sélection naturelle]] est très apprécié lorsqu'il s'agit d'intituler des WEBM filmant des accidents ou témoignant de l'incompétence de certains individus qui entraînera de graves conséquences. On retrouve des variantes toujours plus nombreuses de l'expression, telles que : ''la sélection fut 100% naturelle'', ''la nature prend le dossier en charge'', ''la nature n'est pas de cet avis'', etc. En voici deux exemples : 
[https://jvarchive.com/forums/42-51-71409556-1-0-1-0-webm-un-malien-tente-un-plongeon-a-st-barth-la-nature-soccupe-du-dossier <nowiki> [WEBM] Un MALIEN tente un PLONGEON à ST-BARTH, la NATURE s'occupe du DOSSIER</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71435766-1-0-1-0-webm-un-petit-moment-d-inattention-sur-la-route-la-selection-ne-se-fait-pas-attendre.htm <nowiki>[WEBM] Un petit MOMENT d'INATTENTION sur la ROUTE, la SÉLECTION ne se fait PAS ATTENDRE</nowiki>]

== Réaction de la [[modération]] ==
=== Avant mai 2024 ===
Il n'y a officiellement pas de réglementation à propos des WEBM sur les forums.<ref>https://www.jeuxvideo.com/forums/message/1180766811</ref> Cependant, leur partage n'est généralement pas très apprécié par la modération du fait qu'ils peuvent rapidement conduire à la diffusion de vidéos hors-charte.
Ainsi, les topics WEBM sont la plupart du temps supprimés après une durée relativement courte surtout lorsque les vidéos qu'ils incluent ne respectent par la [[charte]] et remplissent le motif ''Image ou vidéo choquante, gore'', malgré le grand nombre de forumeurs qui apprécient ces topics.

=== À partir de mai 2024 ===
Le 28 mai 2024, les forumeurs remarquent que les posts contenant des liens redirigeant vers du contenu hébergé sur [https://streamable.com Streamable], [https://webmshare.com webmshare] et [https://issoutv.com IssouTV] sont automatiquement supprimés<ref>https://www.jeuxvideo.com/forums/42-51-74327261-1-0-1-0-censure-les-videos-streamable-desormais-auto-supprimee-sur-le-forom.htm</ref>, ce qui provoque colère et dépit. [https://webm.red webm.red] et [https://www.risishack.com/ RisiShack] sont cependant épargnés. Les [[administrateur|administrateurs]] de jeuxvideo.com se justifient de la manière suivante :
{{BoxCitation|Citation=Les vidéos hébergées sur ces plateformes diffusent du contenu qui ne respecte pas la charte du forum et demandent une bande passante conséquente de modération. Par conséquent ces dernières sont interdites.<ref>https://image.noelshack.com/fichiers/2024/22/2/1716915626-screnn5874456.png</ref>|Auteur=Service réclamations de jeuxvideo.com}}

{{SectionRéférences}}

{{Article de qualité}}
[[Catégorie:Article de qualité]]
[[Catégorie:Vocabulaire externe]]

WEBM

2024-05-28T18:14:46Z

HelloWorld5000 : /* Réaction de la modération */

[[File:WebM_logo.png|vignette|250px|Le logotype officiel du format WebM.]]

'''WEBM''' (stylisé ''WebM'') est un format de fichier vidéo principalement destiné à être utilisé sur le Web. Ce terme est par extension utilisé par le [[Blabla 18-25 ans|18-25]] pour qualifier les vidéos que se partagent les [[forumeur|forumeurs]] entre eux. Les WEBM sont généralement appréciés, si bien que certains forumeurs se sont spécialisés dans ce domaine. Les topics comportant en titre une balise ''[WEBM]'' indiquent qu'ils contiennent une telle vidéo.

= Contenu =
== Dénomination ==
Bien que WEBM désigne à l'origine un format de fichier vidéo spécifique, on nomme habituellement ''WEBM'' toute vidéo partagée entre [[forumeurs]], hébergée et relayée sur un service Web prévu à cet effet (voir [[WEBM#Plateformes d'hébergement et de relais|la section attitrée de cet article]]), avec comme seul intérêt la vidéo en elle-même. Une faible minorité de forumeurs puristes prône l'utilisation de ce terme exclusivement concernant les fichiers portant cette extension<ref>https://www.jeuxvideo.com/forums/message/1214151400</ref>. 
Les vidéos présentes sur les réseaux sociaux, YouTube ou toute autre plateforme très modérée ne sont quant à eux habituellement pas vus comme des WEBM car ce style de contenu est souvent éloigné de ce qu'aiment se partager les forumeurs (voir [[WEBM#Nature des WEBM|la section suivante]] pour plus de détails).
== Nature des WEBM ==
Les WEBM partagés par les forumeurs ont principalement pour but de faire rire ou de surprendre. La plupart du temps, les WEBM mettent en scène des vidéos insolites ou à caractère humoristique. Loin d'êtres niais et gentillets, les WEBM partagés par les forumeurs se révèlent souvent trash voire très explicites.

Plus précisément, il peut s'agir d'accidents routiers, de chutes, d'incidents matériels ou industriels impliquant directement des humains ou non, de scènes de violence relativement légères et rarement gores, ou de nudité, mais également de redpills sur les relations sociales, de contenus glissants etc.

Ceci dit, une partie non-négligeable des WEBM partagés ont un objectif purement humoristique, souvent par leur attrait, contenu ou intitulé absurde.

=== Chine ===
Certains types spéciaux de WEBM ont émergé, par exemple sur la Chine où le but principal des WEBM partagés (réservés à un public averti) est de montrer des accidents du travail ou accidents industriels récurrents en Chine, ainsi que le manque apparent d'empathie qu'éprouvent les Chinois envers leurs compatriotes lorsqu'ils sont victimes d'accidents routiers, en les laissant pour morts, ou encore le décalage qu'il peut y avoir entre les sociétés européennes et asiatiques.<ref>https://www.jeuxvideo.com/forums/42-51-60397834-1-0-1-0-putain-les-webm-du-pave-chine.htm</ref>
On retrouve la plupart de ces WEBM dans le [[Pavé Chine|pavé Chine]].

=== Pneus tueurs ===
Cette appellation est réservée aux WEBM filmant des scènes de pneus qui lorsqu'ils se décrochent de leur châssis peuvent causer de gros dégâts humains ou matériels. Une [[boucle]] est alimentée par le forumeur ''PneuTueur'' à ce sujet <ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=pneus%20tueurs</ref>. Il semble que l'expression ait été pour la première fois utilisée sur [https://www.jeuxvideo.com/forums/42-51-70854977-1-0-1-0-webm-les-pneus-tueurs-uniquement-en-chine-etonnant.htm ce topic], et a été largement popularisée depuis lors.

=== WEBM du malaise ===
{{Article connexe|Malaisologie}}
[[File:webm-malaise.png|vignette|200px|Le topic ''WEBM du malaise'' du nouvel an 2023.]]
Certains WEBM se distinguent des autres par leur capacité à provoquer un malaise considérable chez les forumeurs : il s'agit des WEBM dits « du malaise », mettant souvent en scène des personnages archétypaux du [[french dream]] (comme des [[Magalie]]) ou des ''cas sociaux'' de TikTok.<ref>https://www.jeuxvideo.com/forums/42-51-71308627-1-0-1-0-boucle-cest-lheure-des-webm-du-malaise.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71498712-1-0-1-0-soiree-nouvel-an-webm-la-compilation-ultime-des-webm-du-malaise.htm</ref> C'est par exemple le cas de la vidéo [[Et Tic et Tac hein hein|''et tic et tac hein hein'']].

== Plateformes d'hébergement et de relais ==
Les plateformes d'hébergement sont les services Web qui hébergent les WEBM dont les forumeurs se partagent les liens. Souvent, ce sont ces derniers qui ajoutent eux-mêmes la vidéo sur une plateforme telle que Streamable ou webmshare, mais il se peut également qu'ils partagent le lien "brut" amenant à la vidéo originelle (liens [[4chan]], Reddit, etc.). 
Les plateformes d'hébergement/relais de WEBM les plus utilisées par les forumeurs sont (par ordre approximatif de popularité) :
* [https://streamable.com Streamable]
* [https://webmshare.com webmshare]
* [https://4chan.org 4chan] (notamment le board ''/gif/'')
* [https://issoutv.com/ IssouTV]
* [https://webm.red/ webm.red]
* [https://www.reddit.com Reddit] (notamment les subreddits ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'')
* [https://orbitum.space/ orbitum.space]
* [https://www.risishack.com/ RisiShack].

Stremable et webmshare sont les plateformes les plus populaires sur le forum. Streamable a l'avantage de prendre en charge la majorité des formats vidéo (dont WEBM et MP4) mais ne permet pas de télécharger nativement du contenu, contrairement à webmshare qui n'héberge que les fichiers WEBM et autorise le téléchargement de vidéos. Les contenus choquants ou illégaux sont occasionnellement supprimés sur Streamable, et leur auteur banni, ce qui n'arrive visiblement jamais sur webmshare : il semble que ce soit la plateforme la plus stable. De plus, il est nécessaire de créer un compte sur Streamable afin que les vidéos uploadées y soit conservées plus d'un jour, tandis que webmshare peut être utilisée en tant qu'invité. Le contenu hébergé sur webmshare ne peut être lu sur iPhone<ref>https://www.jeuxvideo.com/forums/42-51-70753532-1-0-1-0-tu-as-l-iphone-14-oui-je-ne-peux-pas-lire-les-webm.htm</ref><ref>https://www.jeuxvideo.com/forums/42-51-71211520-1-0-1-0-j-arrive-pas-a-lire-les-webm-sur-mon-iphone-13.htm</ref>. Les deux demeurent (septembre 2023) largement en tête quant au nombre de vidéos partagées sur le forum. 
IssouTV a été comme son nom l'indique spécialement créé pour les utilisateurs de [[jeuxvideo.com|JVC]] et demeure assez utilisé. 
Le board ''/gif/'' de [[4chan]] contient un grand nombre de vidéos pornographiques mais également du contenu trash et gore. Très souvent, les contenus hébergés sur le ''/gif/'' de 4chan sont supprimés quelques semaines voire mois après ; on ignore s'il s'agit de l'action d'administrateurs ou d'un système automatique. Ainsi, les liens 4chan des anciens topics ne redirigent souvent que vers une erreur 404. Il est donc plutôt recommandé de télécharger le contenu hébergé sur 4chan et de le déposer sur une plateforme plus fiable. 
webm.red est une alternative à webmshare peu utilisée mais qui présente à peu près les mêmes fonctionnalités (prise en charge du format WEBM seulement, possibilité de télécharger les vidéos, etc.). 
Les threads Reddit ''WinStupidPrizes'', ''CrazyFuckingVideos'' et ''DarwinAwards'' contiennent quant à eux du contenu relativement trash.
La plateforme décentralisée ''orbitum.space'', gérée par des [[forumeurs]], accueille parfois des vidéos censurées sur ''jeuxvideo.com'' ; RisiShack, très peu utilisé, héberge des fichiers MP4.

Il est à noter que les topics comportant un lien YouTube, Twitter ou TikTok portent généralement une balise ''[WEBM]'' bien qu'ils ne puissent être considérés comme tel au sens strict. Certains forumeurs puristes ne manquent pas de le faire remarquer.<ref>https://jvarchive.com/forums/42-51-71462933-1-0-1-0-webm-ce-boule-va-vous-rendre-maboule</ref>

=== Anciennes plateformes d'hébergement ===
Il semble que d'autres plateformes aient été relativement populaires dans le passé ; c'est notamment le cas de ''webm.land'' et de ''yuki.la''.<ref>https://www.jeuxvideo.com/forums/42-51-55865982-1-0-1-0-webm-no-trash-hun-j-veux-pas-de-410-moi-svp.htm</ref> Ces services Web sont aujourd'hui fermés et inaccessibles. Il en est de même pour le contenu qui avait été hébergé dessus.

=== Script ===
Un [[script|userscript]] ''StreamableDownloader'' a été développé par un membre du forum pour permettre aux utilisateurs de télécharger les vidéos hébergées sur [https://streamable.com Streamable], voir [https://greasyfork.org/fr/scripts/453105-streamabledownloader la page d'accueil du script].

=== WEBM originaux ===
La plupart du temps les WEBM sont relayés sur les plateformes précédemment citées, mais les originaux sont souvent trouvés sur des sites trashs/gores tels que WebChoc, Bestgore, Kaotic, et auparavant LeakReality avant qu'il ne soit supprimé. Les liens vers ces plateformes sont cependant très rares afin de minimiser le risque de censure, et les forumeurs préfèrent uploader le contenu en question sur une des plateformes précédemment citées.
Certains WEBM proviennent directement de TikTok mais semblent être beaucoup moins appréciés par la communauté du fait de leur contenu jugé souvent peu intéressant et de la désapprobation générale de ce réseau social par le forum. On peut également retrouver des WEBM hébergés à l'origine sur YouTube ou Twitter. Ces trois derniers étant plus strictement modérés, ce sont souvent des WEBM softs qui découlent de là-bas. De ce fait, on leur préfère la balise ''[VIDÉO]'' (voir [[#Balise_VIDÉO|la sous-partie éponyme de cet article]]).

= Topics WEBM =
Les [[topic|topics]] WEBM sont très courants et très populaires sur le [[Blabla 18-25 ans|18-25]], mais demeurent trouvables presque exclusivement sur ce forum. On y compte environ une vingtaine de nouveaux topics WEBM par jour<ref>https://jvarchive.com/topic/recherche?searchType=titre_topic&search=webm</ref>.

== Types de topics WEBM ==
On distingue deux types de topics WEBM :
* Des topics à "WEBM unique" ayant pour but de présenter un seul WEBM, dont le lien est présent dans le premier message de l'[[OP]]. 
[https://www.jeuxvideo.com/forums/42-51-71425835-1-0-1-0-webm-il-crie-woop-woop-puis-fait-une-prise-de-catch-a-son-micro-ondes-et-devient-tetraplegique.htm <nowiki>[WEBM] Il crie « WOOP WOOP » puis FAIT une PRISE de CATCH à son MICRO-ONDES et devient TÉTRAPLÉGIQUE</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70627502-1-0-1-0-webm-il-colle-une-voiture-sur-l-autoroute-la-selection-fut-naturelle.htm <nowiki>[WEBM] Il colle une VOITURE sur l'AUTOROUTE, la sélection fut NATURELLE</nowiki>]
* Ainsi que des topics "compilation" où l'auteur poste en continue des WEBM pendant plusieurs minutes ou dizaines de minutes (dépendant de la quantité de WEBM dont l'[[OP]] est en possession, de la réception du topic par les autres forumeurs, et surtout de la réaction de la [[modération]]). 
[https://www.jeuxvideo.com/forums/42-51-71421226-1-0-1-0-webm-ils-jouent-a-biere-pong-un-pere-noel-apparait-et-se-casse-le-coccyx.htm <nowiki>[WEBM] Ils jouent à BIÈRE-PONG, un PÈRE NOËL APPARAÎT et se CASSE le COCCYX</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71450605-1-0-1-0-webm-il-evite-de-justesse-sa-tronconneuse-se-remet-en-question.htm <nowiki>[WEBM] Il évite de justesse sa TRONÇONNEUSE, se REMET en QUESTION</nowiki>] 

Bien que les topics à WEBM unique soient les plus courants sur le forum, les topics de compilation sont généralement très appréciés par la planète forum : ils montent facilement à plusieurs centaines de connectés et à une dizaine de pages. Il arrive souvent que d'autres amateurs de WEBM y rejoignent l'auteur pour poster leurs vidéos.

=== Topics [[fake|fakes]] ===
Certains topics [[troll|trolls]] annoncent dans leur titre une vidéo imaginaire à l'intitulé très aguicheur et insolite, où le premier message est parfois accompagnés de la mention [[post ou cancer]] ou ses dérivés, ''pourquoi as-tu cliqué ?'', ''"cette vidéo n'existe pas'', ''j'aimerais bien voir ça'', simplement dans le but d'attirer des connectés sur le topic. S'ensuit alors des réponses ironiques de type ''pour voir la vidéo'' ou encore ''t'as oublié le lien''. En voici deux exemples : 
[https://www.jeuxvideo.com/forums/42-51-71421330-1-0-1-0-webm-il-plante-une-hache-sur-un-cheval-qui-le-catapulte-dans-le-composte.htm <nowiki>[Webm] Il plante une hache sur un cheval qui le catapulte dans le composte</nowiki>]. 
[https://www.jeuxvideo.com/forums/42-51-71450141-1-0-1-0-webm-cette-japonaise-chie-une-buche-de-noel-dans-l-assiette-de-son-copain.htm <nowiki>[WEBM] Cette JAPONAISE CHIE une bûche de noël dans l'assiette de son COPAIN</nowiki>]. 

Il est évident que ces topics sont très peu appréciés et souvent [[DDB]] en masse, puisqu'ils occasionnent une déception chez les forumeurs ayant cliqué.

=== Certification de [[nofake]] et [[éclaireur]] ===
[[Fichier:nofake sticker.png|vignette|200px|Le fameux sticker nofake étant généralement admis comme preuve incontestable d'un nofake.]]

Parallèlement aux topics fake, la certification de [[nofake]], réalisée par un forumeur autre que l'auteur, est un moyen pour ceux qui ont cliqué sur le topic de savoir si le titre est en bonne adéquation avec le contenu de la vidéo présentée. Ces certifications, qui permettent à la fois de faire gage de qualité et d'[[up]] le topic concerné, sont parfois demandées par l'[[OP]] dans son post pour démontrer la véracité du titre aussi invraisemblable soit-il. 
On note diverses déclinaisons de cette certification, telles que : [[le titre est malheureusement nofake|''Le titre est malheureusement nofake'']], ''Je certifie que le titre de l'annotateur principal de ce fil de discussion est en total adéquation avec le contenu du présent court-métrage présenté sur cette page HTML sur laquelle vous naviguez actuellement.'', etc. 
L'[[éclaireur]], quant à lui, est parfois demandé sur les topics WEBM par un forumeur réticent à l'idée de cliquer sur le lien partagé par l'auteur à cause d'un titre de topic douteux, de peur de tomber sur un screamer ou du contenu gore, choquant. Les éclaireurs ont ainsi pour mission de vérifier la vidéo et de signaler si cette dernière est ''safe'' ou non. L'éclaireur peut dans la foulée réaliser la certification de nofake.

== Titres ==
Les titres de topics WEBM sont souvent aguicheurs et insolites ; ils caricaturent les contenus ''putaclicks'' d'Internet en reprenant leurs éléments de langage. Parmi ces derniers, nous pouvons citer entre autres : ''la suite risque de vous surprendre'', ''ça tourne mal'', ''sa réaction est étonnante'', etc. 
[https://www.jeuxvideo.com/forums/42-51-71483319-1-0-1-0-webm-il-dort-dans-son-lit-se-mange-une-branche-sa-pasteque-tombe-dans-l-eau.htm <nowiki> [WEBM] Il dort dans son lit, se mange une branche, sa pastèque tombe dans l'eau </nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-70167283-1-0-1-0-webm-il-tente-le-bah-sort-la-suite-risque-de-vous-surprendre.htm <nowiki>[WEBM] il tente le BAH SORS, la suite risque de vous surprendre</nowiki>]


=== Balise [VIDÉO] ===
À défaut de comporter la balise WEBM (cependant largement majoritaire pour les topics de ce genre), certains intitulés comportent la mention "vidéo", ce qui arrive généralement lorsque l'OP est un [[newfag]] ne connaissant pas encore bien les codes du forum ou lorsque la vidéo partagée n'est pas un WEBM à proprement parler.

=== Sélection naturelle ===
Le terme de [[sélection naturelle]] est très apprécié lorsqu'il s'agit d'intituler des WEBM filmant des accidents ou témoignant de l'incompétence de certains individus qui entraînera de graves conséquences. On retrouve des variantes toujours plus nombreuses de l'expression, telles que : ''la sélection fut 100% naturelle'', ''la nature prend le dossier en charge'', ''la nature n'est pas de cet avis'', etc. En voici deux exemples : 
[https://jvarchive.com/forums/42-51-71409556-1-0-1-0-webm-un-malien-tente-un-plongeon-a-st-barth-la-nature-soccupe-du-dossier <nowiki> [WEBM] Un MALIEN tente un PLONGEON à ST-BARTH, la NATURE s'occupe du DOSSIER</nowiki>] 
[https://www.jeuxvideo.com/forums/42-51-71435766-1-0-1-0-webm-un-petit-moment-d-inattention-sur-la-route-la-selection-ne-se-fait-pas-attendre.htm <nowiki>[WEBM] Un petit MOMENT d'INATTENTION sur la ROUTE, la SÉLECTION ne se fait PAS ATTENDRE</nowiki>]

== Réaction de la [[modération]] ==
=== Avant mai 2024 ===
Il n'y a officiellement pas de réglementation à propos des WEBM sur les forums.<ref>https://www.jeuxvideo.com/forums/message/1180766811</ref> Cependant, leur partage n'est généralement pas très apprécié par la modération du fait qu'ils peuvent rapidement conduire à la diffusion de vidéos hors-charte.
Ainsi, les topics WEBM sont la plupart du temps supprimés après une durée relativement courte surtout lorsque les vidéos qu'ils incluent ne respectent par la [[charte]] et remplissent le motif ''Image ou vidéo choquante, gore'', malgré le grand nombre de forumeurs qui apprécient ces topics.

=== À partir de mai 2024 ===
Le 28 mai 2024, les forumeurs remarquent que les posts contenant des liens redirigeant vers du contenu hébergé sur [https://streamable.com Streamable], [https://webmshare.com webmshare] et [https://issoutv.com IssouTV] sont automatiquement supprimés<ref>https://www.jeuxvideo.com/forums/42-51-74327261-1-0-1-0-censure-les-videos-streamable-desormais-auto-supprimee-sur-le-forom.htm</ref>, ce qui provoque colère et dépit. [https://webm.red webm.red] et [https://www.risishack.com/ RisiShack] sont cependant épargnés. Les [[administrateur|administrateurs]] de jeuxvideo.com se justifient de la manière suivante :
{{BoxCitation|Citation=Les vidéos hébergées sur ces plateformes diffusent du contenu qui ne respecte pas la charte du forum et demandent une bande passante conséquente de modération. Par conséquent ces dernières sont interdites.|Auteur=Service réclamations de jeuxvideo.com}}

{{SectionRéférences}}

{{Article de qualité}}
[[Catégorie:Article de qualité]]
[[Catégorie:Vocabulaire externe]]

Documentation de l'API Jeuxvideo.com

2024-05-19T19:23:30Z

HelloWorld5000 : /* Requêtes auxiliaires */

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"forums" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyées par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont adressées aux serveurs. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, les URL des pages ainsi que les options (''queries'') restantes selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Documentation de l'API Jeuxvideo.com

2024-05-19T19:22:27Z

HelloWorld5000 : /* Requêtes auxiliaires */

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"forums" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyés par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont envoyées par celui-ci. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, de connaître les URL des pages ainsi que les options (''queries'') possibles selon ce qui a déjà été entré dans le panel de recherche.

Ces requêtes utilisent un ''endpoint'' contenant un token JWT dans lequel sont stockées des informations générales sur la requête (''queries'' notamment). Comme cette clé secrète n'est pas connue, il nous est malheureusement impossible de générer de tels tokens à la demande.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Documentation de l'API Jeuxvideo.com

2024-05-19T18:39:25Z

HelloWorld5000 : /* Queries des dossiers */

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"forums" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyés par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont envoyées par celui-ci. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, de connaître les URL des pages ainsi que les options (''queries'') possibles selon ce qui a déjà été entré dans le panel de recherche.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Documentation de l'API Jeuxvideo.com

2024-05-19T18:38:58Z

HelloWorld5000 : /* Endpoints */

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"forums" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries des dossiers ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/UGd3b2qJ ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Requêtes auxiliaires ===
En parallèle des requêtes envoyés par le site pour rechercher des jeux, news, previews, vidéos ou tests, des requêtes auxiliaires sont envoyées par celui-ci. Elles permettent en particulier de connaître ce qu'il faut afficher sur la page, de connaître les URL des pages ainsi que les options (''queries'') possibles selon ce qui a déjà été entré dans le panel de recherche.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des dossiers triés par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Documentation de l'API Jeuxvideo.com

2024-05-19T14:16:06Z

HelloWorld5000 : /* Endpoints */

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.

Actuellement, deux API sont utilisées : l'api ''v4'' et l'api ''jvc.gg'' :
* L'API ''v4'' est hébergée sur le sous-domaine ''api'', et est actuellement à sa quatrième version (''v4''). Elle est utilisée par l'application mobile JVC. Cette API est privée et ne peut être documentée que par rétro-ingénierie de l'application mobile.
* L'API ''jvc.gg'', d'importance moindre, est hébergée à ''api.jvc.gg''. C'est une API utilisée par les pages Phoenix du site qui sert notamment à la recherche des jeux.

Les anciennes versions sont toujours exploitables avec les ''tokens'' qui leur sont propres{{Commentaire|Autre=potentiellement obsolète}}, mais certains ''endpoints'' renvoient des erreurs HTTP 403.

=Rétro-ingénierie de l'application mobile JVC=
Pour connaître les endpoints de l'API, il faut décompiler l'[https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo application mobile JVC] ou intercepter les requêtes qu'elle envoie.

== Décompilation ==
=== Mise en place du processus de décompilation ===
Pour pouvoir décompiler l'application mobile, vous aurez besoin des outils suivants :
* [https://www.java.com/en/download/ Java 8 ou plus]
* [https://apktool.org/ apktool]
* [https://github.com/skylot/jadx JADX]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici] (privilégiez les versions supérieures à la 5.4.3, sans quoi vous devrez extraire le fichier ''.xapk'' et appliquer le processus de décompilation sur le fichier ''.apk'' principal).

Il vaut mieux renommer le fichier ''.apk'' obtenu pour éviter d'avoir à être embarrassé par de trops longs noms de fichiers. Ici, nous l'avons enregistré sous ''jeuxvideo.apk''.

Suivez les étapes ci-dessous (en remplaçant ''jeuxvideo.apk'' par le nom du fichier ''.apk'' à votre disposition) :
# Dans un terminal ouvert au dossier de l'APK, exécutez la commande suivante :
$ apktool d jeuxvideo.apk jeuxvideo-decompiled
# Ouvrez JADX, activez l'option ''Show flatten packages'' (dans la barre d'outils), dans les préférences du logiciel veillez à avoir changé l'option ''Code comments level'' sur ''DEBUG''.
# Importez les fichiers ''.dex'' de ''jeuxvideo-decompiled'' dans JADX.

=== JvApiService ===
Une fois le code Java disponible, on peut ouvrir l'interface '''JvApiService''' (située dans ''com.jeuxvideo.api.web''), qui contient tous les ''endpoints''. L'application utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, et la classe contient tous les ''endpoints'' formels de l'API.

''Extrait de l'interface JvApiService''
<pre>
@POST("contents/{contentID}/comments")
Call<UserComment> addComment(@Path("contentID") String str, @Body UserComment.Body body);

@POST("contents/{contentID}/comments/{commentID}/vote")
Call<UserComment> addCommentVote(@Path("contentID") String str, @Path("commentID") String str2, @Body UserComment.Vote vote);
</pre>

Interface complète disponible [https://pastebin.com/WiQiutAf ici].

=== SigningInterceptor ===
La classe '''SigningInterceptor''' (du package ''com.jeuxvideo.api.utils''), permet de déduire la valeur du ''header Jvc-Authorization'' à envoyer dans les requêtes à l'API.
<pre>
public static String m27149f(String str, String str2, String str3, String str4, String str5) {
StringBuilder sb2 = new StringBuilder();
sb2.append("550c04bf5cb2b\n");
sb2.append(str);
sb2.append("\n");
sb2.append(str2);
sb2.append("\n");
sb2.append(str3);
sb2.append("\n");
sb2.append(str4);
sb2.append("\n");
if (str5 == null) {
str5 = "";
}
sb2.append(str5);
String m14428b = CryptoUtils.m14428b("d84e9e5f191ea4ffc39c22d11c77dd6c", sb2.toString());
return "PartnerKey=550c04bf5cb2b, Signature=" + m14428b + ", Timestamp=" + str;
}
</pre>

Classe complète disponible [https://pastebin.com/sMpiYDqQ ici].

=== JVApi et UserAgentInterceptor ===
'''JVApi''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) et '''UserAgentInterceptor''' (du package ''com.jeuxvideo.api.utils'') permettent de déduire le ''user-agent'' et la valeur des ''headers'' contenant des informations sur la version et la plateforme.

=== JVApiManager ===
La classe '''JVApiManager''' (du package arbitrairement nommé ''p379s3'' car nom perdu lors de la compilation) est celle qui envoie les requêtes à l'API. Elle permet de savoir quelles variables sont passées à la requête vers tel ''endpoint''.

Classe complète disponible [https://pastebin.com/hDWMZwbq ici].

<div id="jvc-auth-header"></div>
=== Le cas Jvc-Auth-Header ===
'''Jvc-Auth-Header''' est le ''header'' envoyé à l'''endpoint'' nommé ''accounts/register''. Cet ''endpoint'' est crucial en ce qu'il représente l''''unique manière de créer un compte JVC sans le système reCaptcha'''.

Il est actuellement impossible que la requête soit validée par l'API sans ce ''header''.

Il s'avère que ''Jvc-Auth-Header'' contient le [https://stackoverflow.com/questions/37671380/what-is-fcm-token-in-firebase token FCM], un token créé par la plateforme ''FireBase'' de Google et utilisé par l'application mobile pour accéder aux bases de données. Ce token est unique à chaque appareil et est créé à chaque installation de l'application mobile. En outre, il permet à l'API de savoir si l'application a déjà effectué une requête d'inscription dans les dernières 24 heures et, le cas échéant, de bloquer les requêtes d'inscription.

Il semble malheureusement impossible de générer de tels tokens « à la demande », en tout cas sans connaître les noms et clés des services FireBase dédiés à l'application.

<div id="interception"></div>

== Interception du trafic ==

Il est possible d'intercepter le trafic émis par l'application mobile lorsqu'elle est exécutée sur un appareil afin de connaître en détail les requêtes envoyées à l'API.

Cette méthode est indépendante de la précédente qui nécessitait de décompiler l'APK. Ici, vous aurez besoin du fichier APK original.

=== Mise en place du processus d'interception ===
Pour pouvoir intercepter le trafic de l'application mobile, vous aurez besoin des outils suivants :
# [https://developer.android.com/studio?hl=fr Android Studio]
# [https://httptoolkit.com/ HTTP Toolkit]

Il faut également le fichier ''.apk'' de l'application mobile, téléchargeable [https://apkpure.fr/fr/jeuxvideo-com-pc-et-consoles/com.jeuxvideo ici].

Pour commencer, il vous faut créer un appareil virtuel avec Android Studio : suivez pour cela le tutoriel disponible à [https://developer.android.com/studio/run/managing-avds?hl=fr cette adresse]. Pour que HTTP Toolkit puisse intercepter le trafic de l'application, il faut choisir un appareil ne disposant pas de ''Google Play''. Nous vous conseillons de choisir le téléphone Pixel 6 Pro et l'image système Tiramisu (niveau d'API 33, Android 13.0). Une fois l'appareil virtuel créé, lancez-le.

Une fois ceci fait, ouvrez le logiciel HTTP Toolkit puis dans le menu principal choisissez l'option ''Android Device via ADB'' qui devrait désormais être accessible. HTTP Toolkit va automatiquement installer tous les logiciels nécessaires sur l'appareil ; vous serez invités, sur l'appareil, à autoriser une connextion VPN à HTTP Toolkit : appuyez sur « OK ».

Ensuite, vous devrez utiliser ADB pour installer l'APK sur l'appareil virtuel. Premièrement, il vous faut ajouter ADB à la variable PATH de votre ordinateur ; consultez la section « How to use ADB from any directory on your PC or Mac » de [https://www.xda-developers.com/install-adb-windows-macos-linux/ cet article], qui contient les étapes à suivre sur Windows, MacOS et Linux.

Ouvrez un terminal de commande dans le dossier où se trouve l'APK et exécutez <code>adb install jeuxvideo.apk</code> (remplacez ''jeuxvideo.apk'' par le nom du fichier APK téléchargé). Une fois la commande exécutée, vous n'avez plus qu'à lancer l'application mobile et observer quelles requêtes sont envoyées dans le panel ''View'' de HTTP Toolkit.

Vous pouvez désormais voir quelles requêtes sont passées à l'API, ainsi que les ''headers'' et ''body'' associés. Par exemple lorsque l'on se connecte :
[[File:http_toolkit.png|center|500px]]

=API v4=

== Préambule ==
L'API v4 utilise une sécurité, l'en-tête HTTP <code>Jvc-Authorization</code> , sa valeur dépend d'une clé fixe <code>partner_key</code>, d'une <code>signature</code> et de la <code>date</code> .

Le ''header'' de vos requêtes devra toujours être de la forme :
<pre>
"Jvc-Authorization" : header,
"User-Agent" : "JeuxVideo-Android/338",
"Jvc-App-Platform" : "Android",
"Jvc-App-Version" : 338,
"Content-Type" : "application/json"
</pre>
Où ''header'' est égal à une chaîne de caractères de la forme ''"PartnerKey=partner_key, Signature=signature, Timestamp=timestamp".

Veuillez consulter l'[[#annexe|annexe]] pour trouver un script Python permettant de créer ce ''header''.

===Authentification===
Comme pour l'ancienne API, le cookie ''coniunctio'' est toujours le cookie de session utilisateur. Il doit être récupéré avec l'appel au point d'entrée ''accounts/login'' (voir tableau POST) puis il doit être envoyé dans une en-tête HTTP <code>"Cookie" : "coniunctio={coniunctio}"</code> pour chaque appel.

<div id="sous-domaine"></div>
== Comportement du sous-domaine ==
Il est intéressant de remarquer que l'API se comporte souvent en véritable sous-domaine, de manière similaire au site www.jeuxvideo.com de base : par exemple, si vous êtes sur un [[topic]] ou un [[forum]], il vous suffit de remplacer dans l'URL « www » par « api » et vous vous trouverez sur une page aux informations identiques quoique présentées de manière différente. Ainsi, les URL seront de la forme <code>https://api.jeuxvideo.com/forums/0-51-0-1-0-1-0-blabla-18-25-ans.htm</code>.

[[File:forum_api.png|vignette|350px|Le forum [[Blabla 18-25 ans]] sur le site de l'API.]]

L'API ne fonctionne donc pas que par ''endpoints''.

{{clear}}

==Endpoints « formels » ==
Il s'agit des ''endpoints'' « documentés » dans le code de l'application mobile et qui se comportent différemment des services de l'API qui ne se contentent que de « copier » le contenu JVC (voir sous-section précédente).

'''URL de base''': ''<nowiki>https://api.jeuxvideo.com/v4/</nowiki>''

*'''PATH''': chemin d'accès de l'''endpoint''
*'''PARAMS, HEADERS''':
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>. Note : dans la plupart des cas, le paramètre <code>accountId</code> peut être remplacé par la valeur <code>me</code> lorsque la requête doit pointer sur le compte connecté.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''': par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''': Corps de la requête au format JSON
Le fichier JSON contenant les <code>id</code> des ''params'' et des ''query strings'' <code>chronicles</code> <code>modes</code> <code>genres</code> <code>events</code> <code>machine</code> <code>categories</code> (obtenu via la requête ''GET config'') est disponible [https://pastebin.com/bnAu6tFL ici].
{| class="wikitable sortable"
|+POST
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|addComment
|contents/{contentID}/comments
|'''contentID''' int
|<pre>"content": "commentaire"</pre>
|-
|addCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|<pre>"type": 1 ou -1</pre>
|-
|addReply
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|addReview
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' int
|<pre>"content": "Super jeu !",
"mark": 4,
"onProfile": true
</pre>
|-
|login
|accounts/login
|
|<pre>"alias": "pseudo",
"password": "mot_de_passe"</pre>
|-
|logout
|accounts/logout
|
|
|-
|register
|accounts/register
| '''header''' : <code>"Jvc-Auth-Token" : str</code>
|<pre>"email": "email",
"alias": "pseudo",
"password": "motdepasse",
"optin": false
</pre>
|-
|reinitPassword
|accounts/reset
|
|<pre>"alias": "pseudo",
"password": "nouveau",
"session": "",
"captcha": {
"imageKey": "",
"imageName": "",
"imageValues": [
"val1",
"val2"
]
}
</pre>
|-
|reportAccount
|accounts/{accountId}/report
|'''accountId''' int
|<pre>"reason": 1,
"message": "Raison"</pre>
|-
| reportComment
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": "Valeur"
"valeur_captcha": "Valeur"
}
</pre>
|-
|reportReview
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' int
'''reviewId''' int
|<pre>"reason": 1,
"message": "Raison",
"captcha": {
"session": "clé"
"clé_captcha": ""
"valeur_captcha": ""
}</pre>
|-
|restoreComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content" : "comment"</pre>
|-
|validateAccount
|accounts/confirm
|
|<pre>"id": 123,
"hash": "hash",
"alias": "pseudo",
"password": "mdp"
</pre>
|-
|validateSignature
|general/stores/android/validation
|
|<pre>"signature": "signature",
"signed_data": "signed_data"
</pre>
|-
|addFavoritesForums
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
|addFavoritesGames
|accounts/me/favorites/games
|
|<code>"games" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|addFavoritesTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des forums</code>
|}
Ci-dessous figurent les requêtes ''GET'', qui se comportent comme des recherches selon les filtres passés en ''queries''.
Les ''queries'' de type <code>str</code> (chaînes de caractère) représentent des ID répertoriées dans la réponse à la requête <code>general/config</code> (sous forme de fichier JSON, disponible [https://pastebin.com/bnAu6tFL ici]).
Si l'on souhaite filtrer les résultats selon leur nature (''news'', vidéos, ''previews'', etc.), on dispose du dictionnaire suivant (provenant de l'application mobile) qui à chaque nature de document associe l'ID des catégories associées :
<pre>
{'videos': '6,13,14,15,16,17,145,19,20',
'news': '50',
'previews': '55',
'tests': '56,57',
'all': '6,13,14,15,16,17,145,50,19,20,53,55,56,57'}
</pre>
Pour plus de détails, veuillez consulter le fichier JSON de configuration.

Comment vous pouvez le constater, contrairement aux variables de type <code>int</code>, les <code>str</code> peuvent contenir plusieurs valeurs, séparées par des virgules : dans ce cas, elles devront être ''parsées'' selon l'encodage URL (voir l'[[#Annexe|annexe]] où un script Python réalisant cette tâche est mis à disposition).

Les ''queries page'' et ''perPage'', toujours des entiers, représentent respectivement : le numéro de la page de recherche et le nombre d'objets à afficher par page.
Les ID comme ''accountID'' et ''commentID'' sont des entiers. Il est à noter que dans la plupart des cas, ''accountID'' peut être remplacé par la chaîne de caractères ''me'' qui représente l'utilisateur connecté (connu grâce au cookie ''coniunctio'' passé en en-tête de la requête).

{| class="wikitable"
|+GET
!NOM
!PATH
!PARAMS, HEADERS
!QUERY
|-
|config
|general/config
|
|
|-
|getAccount
|accounts/{accountId}
|'''accountId''' int
|
|-
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|'''accountId''' int
|
|-
|getArticle
|contents/{id}
|'''id''' int
|
|-
|getCaptcha
|captcha/start
|
|'''nb''' int
|-
|getChroniclesSummary
|contents/chronicles
|
|'''machines''' str
|-
|getComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' int
'''commentID''' int
|
|-
|getComments
|contents/{contentID}/comments
|'''contentID''' int
|'''page''' int
'''perPage''' int
|-
|getContentBean
|contents/{id}
|'''id''' int
|
|-
|getContentList
|contents
|
|'''categories''' str
'''types''' str
'''events''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getCurrentAccountReport
|accounts/{accountId}/report
|'''accountId''' int
|
|-
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' int
'''commentID''' int
|
|-
|getCurrentReviewReport
|games/{id}/{machine}/reviews/users/{reviewId}/report
|'''id''' int
'''machine''' str
'''reviewId''' int
|
|-
|getFavorites
|accounts/{accountId}/favorites
|'''accountId''' int
|
|-
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFavoritesGames
|accounts/{accountId}/favorites/games
|'''accountId''' int
|
|-
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getFolder
|contents/{id}
|'''id''' int
|
|-
|getGame
|games/{id}/{machine}
|'''id''' int
'''machine''' str
|
|-
| getGameDetails
|games/{id}/{machine}/details
|'''id''' int
'''machine''' str
|
|-
|getGameImages
|games/{id}/{machine}/images
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameList
|games/{type}
|'''type''' str
|'''machines''' str
'''machine''' str
'''genre''' str
'''mode''' str
'''page''' int
'''perPage''' int
|-
|getGameNews
|games/{id}/{machine}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getGameReleaseList
| games/releases
|
| '''month''' str
'''year''' str
'''machines''' str
'''page''' int
'''perPage''' int
|-
|getGameReview
|games/{id}/{machine}/reviews/users/{review}
|'''id''' int
'''machine''' str
'''review''' str
|
|-
|getGameReviews
|games/{id}/any/reviews
|'''id''' int
|
|-
|getGameReviews
|games/{id}/{machine}/reviews
|'''id''' int
'''machine''' str
|
|-
|getGameSummary
|contents/games
|
|'''machines''' str
|-
|getGameUserReviews
|games/{id}/{machine}/reviews/users
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameVideos
|games/{id}/{machine}/videos
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getGameWikis
|games/{id}/{machine}/wikis
|'''id''' int
'''machine''' str
|'''page''' int
'''perPage''' int
|-
|getHeadlineList
| contents/trending
|
|'''machines''' str
'''page''' int
'''perPage''' int
|-
| getHighTechSummary
|contents/hightech
|
|'''machines''' str
|-
|getLightGame
|games/{id}/{machine}/light
|'''id''' int
'''machine''' str
|
|-
|getNews
|contents/{id}
|'''id''' int
|
|-
|getNewsHighTech
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getPageContents
|accounts/{accountId}/page/contents
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getPageReviews
|accounts/{accountId}/page/reviews
|'''accountId''' int
|'''page''' int
'''perPage''' int
|-
|getProfile
|accounts/{accountId}/profile
|'''accountId''' int
|
|-
|getProfilePage
|accounts/{accountId}/page
|'''accountId''' int
|
|-
|getRelatedNews
|contents/{id}/news
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedVideos
|contents/{id}/videos
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getRelatedWikis
|contents/{id}/wikis
|'''id''' int
|'''page''' int
'''perPage''' int
|-
|getStores
|games/{id}/{machine}/stores
|'''id''' int
'''machine''' str
|
|-
|getTechList
|contents/hightech
|
|'''page''' int
'''perPage''' int
|-
|getTopWikis
|contents/wikis
|
|
|-
|getTopsComments
|contents/{contentID}/comments/tops
|'''contentID''' int
|
|-
|getVideo
|videos/{id}
|'''id''' int
|
|-
|getVideosSummary
|contents/videos
|
|'''machines''' str
|-
|search
|search
|
|'''q''' str
|-
|searchArticles
|search/articles
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchAutocomplete
|search/games/autocomplete
|
|'''q''' str
|-
|searchGames
|search/games
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchNews
|search/news
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchVideos
|search/videos
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|searchWikis
| search/wikis
|
|'''q''' str
'''page''' int
'''perPage''' int
|-
|sponso
|general/nativeads
|
|
|}
{| class="wikitable sortable"
|+PUT
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|saveDescription
|accounts/me/profile/description
|
|<pre>"description": "Ma description"</pre>
|-
|saveExcludedMachines
|accounts/me/profile/excluded-machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|saveMachines
|accounts/me/profile/machines
|
|<pre>"machines" : [1, 2, 3, 4] // id des machines</pre>
|-
|updateComment

|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|<pre>"content": "Super jeu !"</pre>
|-
|uploadAvatar
|accounts/me/avatar
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|-
|uploadCover
|accounts/me/cover
| '''header''' : <code>"Content-Type": "application/octet-stream"</code> 
|'''body''' : objet <code>bytes</code> (conversion du fichier image en octets, pas de clé associée)
|}
{| class="wikitable sortable"
|+DELETE
!NOM
!PATH
!PARAMS, HEADERS
!BODY
|-
|deleteComment
|contents/{contentID}/comments/{commentID}
|'''contentID''' int
'''commentID''' int
|
|-
|deleteCommentVote
|contents/{contentID}/comments/{commentID}/vote
|'''contentID''' int
'''commentID''' int
|
|-
|deleteFavorisForum
|accounts/me/favorites/forums
|
|<code>"forums" : [50,51,52] # ID des forums</code>
|-
| deleteFavorisGames
|accounts/me/favorites/games
|
|<code>"forums" : [{"id":"ID du jeu", "machine":"ID de la machine"}]</code>
|-
|deleteFavorisTopics
|accounts/me/favorites/topics
|
|<code>"topics" : [74229153, 74229154] # ID des topics</code>
|}

<div id="annexe"></div>

== Annexe ==
=== Jvc-Authorization ===
Voici un script Python qui permet de construire le ''header'' ''Jvc-Authorization'' :
<pre>
import hashlib, hmac, datetime, urllib.parse

PARTNER_KEY = '550c04bf5cb2b'
HMAC_SECRET = b'd84e9e5f191ea4ffc39c22d11c77dd6c'
DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def auth_header(path: str, method: str = 'GET', query: dict = None) -> str:
# Conversion de path en URL avec urllib.parse.urlparse
date = datetime.datetime.now().isoformat()
parsed_url = urllib.parse.urlparse(f"https://{DOMAIN}/v{API_VERSION}/{path}")
if query:
parsed_url = parsed_url._replace(query=urllib.parse.urlencode(query))

# Création de la chaîne à hash
string_to_hash = [PARTNER_KEY, date, method, parsed_url.netloc, parsed_url.path]
if parsed_url.query:
string_to_hash.append(parsed_url.query)
else:
string_to_hash[-1] += '\n'
string_to_hash = '\n'.join(string_to_hash)

# Hash de la chaîne puis renvoi sous forme de Jvc-Authorization
signature = hmac.new(HMAC_SECRET, msg=string_to_hash.encode('utf-8'), digestmod=hashlib.sha256).hexdigest()
return f"PartnerKey={PARTNER_KEY}, Signature={signature}, Timestamp={date}"
</pre>

=== Requêtes à l'API ===
Voici un script Python permettant d'envoyer des requêtes à l'API et qui utilise la fonction précédente :
<pre>
import requests, json
from requests import Response

DOMAIN = 'api.jeuxvideo.com'
API_VERSION = 4

def call(path: str, method: str = 'GET', query: dict = None, data: dict = None, cookies: dict = None) -> Response:
url = f"https://{DOMAIN}/v{API_VERSION}/{path}"
jv_auth = auth_header(path, method=method, query=query)
headers = {
"Jvc-Authorization":jv_auth,
"Content-Type": "application/json",
"jvc-app-platform":"Android",
"jvc-app-version":"338",
"user-agent":"JeuxVideo-Android/338",
"host":"api.jeuxvideo.com"
}

if data:
data = json.dumps(data)

return requests.request(url=url, method=method, data=data, headers=headers, params=query, cookies=cookies)
</pre>

=== ''Parsing'' des ''queries'' ===
Lors de l'appel à ''contents'' par exemple, vous pouvez passer en ''query'' des chaînes de caractère comme ''categories'' ou ''types''. Ces ''queries'', s'il contiennent plusieurs valeurs, doivent être encodés au format d'encodage URL, ce qui peut être fait en Python :
<pre>
from urllib.parse import quote

categories = "50,53,56" # la recherche récupérera les articles de catégories 50, 53 et 56.
categories_parsed = quote(categories)

query = {"categories": categories_parsed}

# vous pouvez désormais passer ce dictionnaire en query
</pre>

== Accès aux forums ==
Étrangement, il n'existe pas d'''endpoint'' particulier pour envoyer un message ou un topic sur les [[forum|forums]] de jeuxvideo.com.

Lorsque l'application mobile souhaite récupérer les pages des forums, elle envoie une requête au lien usuel de la ressource à ceci près que ''www'' est remplacé par ''api''. La requête renvoie alors une page HTML en guise de réponse, voir la [[#sous-domaine|rubrique en question]].

Ainsi, lorsque l'on cherche à interagir avec les forums, il n'y a pas d'avantage à envoyer des requêtes à l'API plutôt qu'au site de base en l'état.

=== Principe général ===
En premier lieu, afin d'envoyer un message ou un topic sur un forum, il faut bien évidemment que vous soyez connecté et vus devrez donc passer en en-tête de la requête votre cookie ''coniunctio'', récupérable à partir d'une requête à l'''endpoint'' <code>accounts/login</code> envoyant vos identifiants.

[[File:js_form.png|vignette|400px|Les ''inputs'' cachés contenant les valeurs à envoyer dans les requêtes visibles depuis les outils de développeur.]]

En second lieu, vous ne devrez pas seulement envoyer aux serveurs le contenu de votre message (et le titre du topic si besoin) : la requête ''POST'' devra aussi contenir des paires clés-valeurs générées par le site lui-même et qui agissent comme une sorte de protection. Celles-ci sont : ''fs_session'', ''fs_timestamp'', ''fs_version'', ''form_alias_rang'' ainsi qu'un ''hash''.

Heureusement, ces valeurs sont directement disponibles depuis des ''inputs'' cachées dans le code HTML des pages de forums/topics et situées dans la ''div'' nommée ''js-form-session-data''.

Si l'on veut envoyer un message sur un topic (ou un forum), il faudra d'abord envoyer une requête ''GET'' à l'URL associée et récupérer ces valeurs chiffrées avant d'envoyer une requête ''POST'' avec le contenu du message en plus de ces dernières.

=== Script Python ===
La classe Python suivante permet d'interagir avec les forums de cette manière. Il vous suffit d'entrer la valeur de votre cookie ''coniunctio'' et d'appeler les fonctions souhaitées avec le contenu des messages ou topics.

Bien que cette méthode permette d'outrepasser les captchas, il se peut que vous soyez bloqué par le site en envoyant un trop grand nombre de requêtes dans un trop court laps de temps.

<pre>
import requests, json
from requests import Response
from bs4 import BeautifulSoup

DIV_CLASS = 'js-form-session-data'

class ForumClient:
def __init__(self, coniuntio: str):
self._cookies = {'coniunctio':coniuntio}

def _scrape_input_tokens(self, res: Response) -> dict:
soup = BeautifulSoup(res.text, 'html.parser')
form = soup.find('div', {'class':DIV_CLASS})
jsi = form.findChildren("input")

tokens = {
"fs_session":jsi[0].attrs["value"],
"fs_timestamp":jsi[1].attrs["value"],
"fs_version":jsi[2].attrs["value"],
jsi[3].attrs["name"]:jsi[3].attrs["value"],
"form_alias_rang":"1",
"g-recaptcha-response":""
}

return tokens

def _get_forum_URL(self, forum_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/0-{forum_id}-0-1-0-1-0-a.htm').url

def _get_topic_URL(self, topic_id) -> str:
return requests.get(f'https://www.jeuxvideo.com/forums/42-1-{topic_id}-1-0-1-0-a.htm').url

def post_message(self, topic_id: int, message: str) -> Response:
"""
topic_id, int : ID du topic
message, str : votre message

renvoie un objet Response
"""
topic_URL = self._get_topic_URL(topic_id)
res = requests.get(topic_URL, cookies=self._cookies)

data = self._scrape_input_tokens(res)
data['message_topic'] = message

res = requests.post(topic_URL, data=data, cookies=self._cookies)

return res

def post_topic(self, forum_id: int, titre: str, message: str, sondage: dict = None) -> Response:
"""
forum_id, int : ID du forum
titre, str : titre du topic
message, str : corps du topic

[sondage], dict : dictionnaire de la forme {
"question_sondage" : "Question ?",
"reponse_sondage[]" : ["reponse 1", "reponse 2"]
}
"""
forum_URL = self._get_forum_URL(forum_id)
res = requests.get(forum_URL, cookies=self._cookies)
data = self._scrape_input_tokens(res)

data['titre_topic'] = titre
data['message_topic'] = message
if sondage:
data |= sondage
data['submit_sondage'] = '1'

res = requests.post(forum_URL, data=data, cookies=self._cookies)

return res

if __name__ == '__main__':
client = ForumClient("votre coniunctio ici")
# Exemples d'utilisation
# Pour poster un message
client.post_message(74204156, "Je poste depuis Python :)")
# Pour poster un topic
client.post_topic(51, 'Je poste depuis Python', 'Et toi ? :)')
</pre>

== Limitations ==
L'API v4 comporte plusieurs limitations :
* Il est impossible d'outrepasser les protections [[captcha|captchas]] requises par le site notamment pour [[DDB|signaler]] un message.
* Il est impossible de s'inscrire en utilisation l'''endpoint'' <code>accounts/register</code> car celui-ci nécessite un ''header'' contenant le ''token'' FireBase généré lors de l'installation de l'application (voir le [[#jvc-auth-header|paragraphe à ce sujet]]). Une solution serait de créer un grand nombre de machines virtuelles (ou d'en automatiser la création), et pour chacune d'entre elles d'intercepter le trafic de l'application (voir [[#interception|section associée]]) pour récupérer et conserver les ''tokens'' dans un fichier. Cette méthode, longue et fastidieuse, ne permettrait donc pas de générer un nombre infini de comptes. Une autre méthode possible, bien qu'elle n'utilise pas l'API, serait de créer un compte sur le site à l'aide d'un ''webdriver''. Celle-ci fonctionne (l'auteur de ce paragraphe l'a déjà implémentée) mais il serait difficile de la rendre compatible pour toutes les plateformes (du fait de la nécessité d'avoir un VPN gérable depuis un script).
* Il est particulièrement hardu de faire du ''web scraping'' sur les pages de forum puisque l'API renvoie une page HTML et non un fichier JSON dans ce cas.

==Ressources==
*[https://archive.org/details/jeuxvideo.com-pc-et-consoles-5.4.7-apkpure APK 5.4.7] décompilable avec JADX.
*[https://pastebin.com/LWNDQDKy Classe PHP] exploitant l'API (cette classe est incomplète et sera possiblement rendue obsolète dans le temps).

= API jvc.gg =
[[File:phoenix.png|300px|vignette|La page Phoenix des jeux.]]

Cette API est une API distincte de la ''v4'' et utilisée par la partie Phoenix du site, c'est-à-dire les pages listant les jeux, ''reviews'', vidéos, etc., comme [https://www.jeuxvideo.com/tous-les-jeux/ celle-ci]. Elle est hébergée sur le domaine [https://api.jvc.gg api.jvc.gg].

{{clear}}

== Rétro-ingénierie ==
L'API étant privée, il a fallu procéder par rétro-ingénierie pour la documenter.

Les appels à l'API sont effectués depuis un script chargé par les pages Phoenix. Les noms de variable sont obfusqués mais pas les chaînes de caractère : ainsi une partie des ''endpoints'' y sont lisibles. Ce script est téléchargeable [https://archive.org/details/phoenix_script ici].

Il est également possible d'observer les URL et les contenus des requêtes depuis le panneau ''Network'' (ou ''Réseau'') des [https://developer.mozilla.org/fr/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools outils de développement Web].

== Préambule ==
L'API jvc.gg est basée sur l'utilisation de ''JSON Web Token'' (JWT), un standard utilisé pour créer des jetons de sécurité qui permettent de transférer de l'information de manière sécurisée entre deux parties au format JSON.

Lorsque vous visitez pour la première fois une page Phoenix, le serveur de JVC renvoie une requête comportant un cookie ''accessToken''. La valeur de ce cookie est une chaîne de caractères encodée au format JWT qui contient notamment votre ID de compte et la valeur de votre cookie ''coniunctio''. La fonction Python suivante permet de récupérer le cookie ''accessToken'' en fonction de votre cookie ''coniunctio'' :
<pre>
def get_access_cookie(coniunctio: str) -> str:
cookies = {'coniunctio':coniunctio}
res = requests.get('https://www.jeuxvideo.com/tous-les-jeux/', cookies=cookies)
access_cookie = res.headers['set-cookie'].split(';')[0].replace('accessToken=', '')
return access_cookie
</pre>

Ce cookie vous sera utile lorsque les requêtes envoyées sont destinées à opérer sur votre compte.

== Endpoints ==
Le tableau suivant répertorie les ''endpoints'' connus de cette API. Voici la signification de ses colonnes :

*'''PATH''' : chemin de l'''endpoint''.
*'''PARAMS, HEADERS''' :
** '''param''' : variable entre accolades à remplacer dans l'URL, suivie dans la documentation de son type (''str'' ou ''int''). Par exemple, <code>contents/{contentID}/comments</code> doit être appelé comme suit : <code>contents/123456/comments</code>.
** '''header''' : ''header'' particulier à inclure dans l'en-tête de la requête. Si pas de spécification, l'en-tête ne contient que les ''headers'' de base spécifiés plus haut (''User-Agent'', ''Jvc-Authorization'', etc.).

*'''QUERY''' : valeur à ajouter à l'URL permettant si précisée de filtrer les résultats. Par exemple pour les deux query ''page'', ''perPage'' int, l'URL devra être: <code>api.jeuxvideo.com/v4/contents/1234ID/comments?page=1&perPage=30</code>
*'''BODY''' : Corps de la requête au format JSON

=== Les paramètres spéciaux ===
* Le paramètre <code>{accessToken}</code> devra toujours être remplacé par la valeur du cookie éponyme.
* Le paramètre <code>{gameCategory}</code> peut être remplacée par les valeurs suivantes, qui proviennent évidemment du système de classification de JVC :
** <code>all</code> pour avoir la liste de tous les jeux ;
** <code>awaited</code> pour avoir la liste des jeux attendus ;
** <code>popular</code> pour avoir la liste des jeux populaires ;
** <code>best</code> pour avoir la liste des meilleurs jeux ;
** <code>currentBest</code> pour avoir la liste des meilleurs jeux du moment ;
** <code>releases</code> pour avoir la liste des jeux pas encore sortis.

=== Queries des jeux ===
Les ''queries'' renseignent la plateforme, le genre et le mode du jeu. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].

Par exemple, si vous souhaitez obtenir la liste des jeux PS4 de genre action RPG et de forme multi en ligne, votre chaîne de ''queries'' devra être <code>platform=ps4&gameGenre=action_rpg&gameMode=multiplayer_online</code>.

De plus, le ''query'' ''release'' désigne la date de sortie du jeu, '''compatible seulement avec les catégories <code>best</code> et <code>releases</code>'''. Il peut s'agir d'une année ou d'une décennie (dans ce cas, la valeur du ''query'' représentera la première année de la décennie suivie du caractère 'd' ; par exemple, <code>2010d</code> pour les années 2010). Pour les jeux pas encore sortis, ce ''query'' peut également contenir le mois (par exemple : <code>2024-07</code> pour juillet 2024). Incompatible avec la catégorie <code>currentBest</code>.

=== Queries des news ===
Les ''queries'' renseignent la plateforme, le type, le genre et l'événement des news. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des news de jeux PS5 de genre aventure en rapport avec l'événement ''Game Awards'' publiés en 2022, votre chaîne de ''queries'' devra être <code>publicationType=game_news&platform=ps5&gameGenre=adventure&event=id201395&publicationPeriod=2022</code>.

Le ''query publicationPeriod'' peut être : une année, une année suivie du numéro du mois (<code>2024-07</code> pour juillet 2024) ou une décennie (<code>2010d</code> pour les années 2010).

=== Queries des tests ===
Les ''queries'' renseignent la plateforme, le mode et le genre des jeux testés, ainsi que l'encadrement de la note des rédacteurs et la date de publication. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/Dk4SkDkA ici].

Par exemple, si vous souhaitez obtenir la liste des tests de jeux PC de genre aventure, de mode solo ayant eu au moins 14 et datant d'il y a au plus 6 mois, votre chaîne de ''queries'' devra être
<code>platform=pc&gameGenre=adventure&gameMode=singleplayer&editorialRatingRange=%5B14%2C)&maxAge=P6M</code>

Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé.

=== Queries des previews ===
Les ''queries'' renseignent la plateforme, le genre et l'événement des jeux testés. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/xaqTQPfr ici].

Par exemple, si vous souhaitez obtenir la liste des ''previews'' des jeux PS5 de genre FPS en rapport avec l'événement ''Find Your Next Game'', votre chaîne de ''queries'' devra être <code>platform=ps5&gameGenre=fps&event=fyng</code>.

=== Queries des vidéos ===
Les ''queries'' renseignent le type des vidéos ainsi que la plateforme, le genre et l'événement des jeux traités. La liste complète des valeurs des ''queries'' possibles pour ces attributs est disponible au format JSON [https://pastebin.com/nBUAP4XX ici].

Par exemple, si vous souhaitez obtenir la liste des vidéos ''gameplays'' des jeux PC de genre Action en rapport avec l'événement E3, votre chaîne de ''queries'' devra être <code>publicationType=gameplay&platform=pc&gameGenre=action&event=e3</code>.

=== Queries globaux ===
Ce sont les ''queries'' ''offset'' et ''limit'', de type ''int'', qui représentent respectivement l'indice de l'item dans la liste à partir duquel les items sont listés (par défaut 0) et le nombre d'items à lister (par défaut 100). Ils fonctionnent avec toutes les recherches.

=== Liste des endpoints connus ===

{| class="wikitable"
|+GET
!PATH
!PARAMS
!QUERY
!DESCRIPTION
|-
|games/{gameCategory}/popularity.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/editorialRating.desc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/releaseDate.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|games/{gameCategory}/title.asc
| '''gameCategory''' str
|'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''offset''' int 
'''limit''' int 
'''release''' str
|Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
|-
|news/datePublished.desc
|
| '''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''publicationPeriod''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/datePublished.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
|-
|reviews/editorialRating.desc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
|-
|reviews/gameTitle.asc
|
|
'''platform''' str 
'''gameGenre''' str 
'''gameMode''' str 
'''editorialRatingRange''' str 
'''maxAge''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
|-
|previews/datePublished.desc
|
|'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
|-
|topics/datePublished.desc
|
| '''offset''' int 
'''limit''' int
|Renvoie la liste des articles triés par date de publication croissante et satisfaisant les ''queries''.
|-
|videos/datePublished.desc
|
|'''publicationType''' str 
'''platform''' str 
'''gameGenre''' str 
'''event''' str 
'''offset''' int 
'''limit''' int
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
|-
|me/{accessToken}/privateMessages
| '''accessToken''' str
|
|Renvoie la liste des 25 derniers messages privés.
|-
|me/{accessToken}/notifications/subscription
| '''accessToken''' str
|
|Renvoie la liste des dernières notifications.
|-
|me/{accessToken}/notifications/privateMessage/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/unseenCount
| '''accessToken''' str
|
|Renvoie le nombre de notifications non-vues.
|-
|me/{accessToken}/profile
| '''accessToken''' str
|
|Informations du profil.
|-
|config/menu
|
|
|Informations à afficher sur les pages Phoenix.
|}

{| class="wikitable"
|+POST
!PATH
!PARAMS
!BODY
!DESCRIPTION
|-
|me/{accessToken}/notifications/subscription/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-vues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnseenCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-vus.
|-
|me/{accessToken}/notifications/subscription/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de notifications non-lues.
|-
|me/{accessToken}/notifications/privateMessage/resetUnreadCount
| '''accessToken''' str
|
|Met à zéro le nombre de messages privés non-lus.
|-
|me/{accessToken}/notification/{notifId}/setRead
| '''accessToken''' str 
'''notifId''' int
|
|Lit une notification.
|-
|me/{accessToken}/privateMessage/{messageId}/setRead
| '''accessToken''' str 
'''messageId''' int
|
|Lit un message privé.
|-
|_auth/{accessToken}/logout
| '''accessToken''' str
|
|Se déconnecter.
|}

=Ancienne API (dépréciée) =
{{Bannière Note|Contenu=Le contenu qui va suivre concerne l'ancienne API qui n'existe plus.}}
==Identification ==
L'API utilise le nom de domaine [https://ws.jeuxvideo.com/ ws.jeuxvideo.com]. Pour y accéder, il faut utiliser un des identifiants ci-dessous (authentification HTTP basique).

Tous ces identifiants fonctionnement actuellement, et je n'ai pas repéré de page semblant afficher un comportement différent selon.

{| class="wikitable"
|
! scope="col" | Utilisateur
! scope="col" |Mot de passe
|-
! scope="row" |Android 1.0
|appandr
|e32!cdf
|-
! scope="row" |Android 2.0.3
|app_and_gnw
|FC?4554?
|-
! scope="row" |Android 2.5
|app_and_ms
|D9!mVR4c
|-
! scope="row" |Android MP
| app_ag_jvmp
|LXnb45=d#
|-
! scope="row" |Android Tab
|nex12sz
|GT4!V2cT
|-
! scope="row" |iPhone
|app_ios_nw
|W!P45-R
|-
! scope="row" |iPad
|ip45de
|XpD5!FT
|}

L'API est accessible en HTTP et en HTTPS, préférez la version HTTPS !

==Utilisation ==
===Connexion===
Pour vous connecter, utilisez la page [https://ws.jeuxvideo.com/mon_compte/connexion.php mon_compte/connexion.php].

Voici les paramètres à envoyer (GET ou POST) :
{| class="wikitable alternance centre plainlinks"
! scope="col" |Paramètre
! scope="col" |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 [[wikipedia:Salt_(cryptography)|salt]].
|}

Vous renconterez potentiellement une erreur vous demandant de remplir un captcha, avec un lien vers l'image, et une balise ''params_form'', qu'il faudra ajouter aux paramètres de la première requête, ainsi que le paramètre ''code'' avec la valeur du captcha.

'''Important : n'ouvrez pas le lien du captcha dans votre navigateur si vous êtes connecté à votre compte JVC ; un captcha différent est renvoyé selon la présence du cookie ''wenvjgol'' (qui ne doit PAS être présent pour afficher un captcha de l'API, sinon vous aurez systématiquement une erreur de captcha invalide).'''

En réponse, vous recevez plusieurs informations présentes dans la CDV, mais surtout le cookie ''wenvjgol'', que vous devrez utiliser pour poster sur les forums et utiliser les messages privés.

Pour information, ''wenvjgol'' signifie ''logjvnew'' à l'envers, et c'est le cookie de session de JVC dont le nom a subi plusieurs transformations au fil des années.

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

[https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=Cisla https://ws.jeuxvideo.com/cgi-bin/passperdu_ws.cgi?email_pseudo=''Cisla'']

===Jeux, astuces, news...===
{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|00.machines_version.xml 00.version_tablette.xml
|Dernière version de l'application, informations sur la publicité, 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 01.jeux/screen_ast/''38024''.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 04.flux_videos_chroniques.xml 04.flux_videos_chroniques-''4''.xml 04.flux_toutes_les_videos.xml 04.flux_toutes_les_videos-''4''.xml
|Même chose pour les derniers articles, tests, astuces et aperçus
|-
|02.news/''1234''.xml 02.news_screen/''1234''.xml
|Voir une news (le nombre correspond à l'id)
|-
|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
|-
|tab_suggest_blocs.xml tab_suggest_forums.xml
| ''À compléter''
|-
| cgi-bin/liste.cgi
|''À compléter''
|}

===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ères à 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 : 
https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml

Exemples d'URL :

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-0-0.xml
|La liste des sujets
|-
|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml
|Rechercher « cactus » dans le titre des topics
|-
|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml
|Un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml
|Formulaire pour créer un topic
|-
|https://ws.jeuxvideo.com/forums/3-50-128244545-1-0-1-0-0.xml
|10 derniers messages d'un topic + formulaire
|-
|https://ws.jeuxvideo.com/forums/5-50-128244545-1-0-1-0-0.xml
| Formulaire de réponse à un topic
|-
|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi
|Envoyer un message (avec les données POST)
|-
|https://ws.jeuxvideo.com/profil/cisla.xml
| Voir une CDV
|}

Pour envoyer un message ou créer un topic : aux données de formulaires qui vous sont communiquées dans la balise ''params_form'', vous devez ajouter le paramètre ''yournewmessage'' qui contient le message et ''newsujet'' qui contient le titre du topic (si vous créez un nouveau topic). Vous devez ensuite attendre une seconde avant d'envoyer les données POST à la page ''forums.cgi''. En cas de captcha à gérer, vous devez répéter l'opération à partir des informations qu'on vous envoie en réponse, avec la solution du captcha en paramètre ''code''.

Vous devez être connecté (envoyer le cookie ''coniunctio'') 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. Les données POST à envoyer sont donc les mêmes sur toutes les versions de JVC.

=== Messages privés===
L'id de l'utilisateur mentionnée ci-dessous correspond à la partie du cookie ''coniunctio'' qui se trouve avant le premier "$".

Une fois connecté, vous devez envoyer le cookie ''coniunctio'' à chaque requête.

{| class="wikitable alternance centre"
! scope="col" |URL
! scope="col" |Description
|-
|jvmp.xml
|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non
|-
| messages-prives/connexion_ws.php
|Les paramètres sont les mêmes que pour la connexion depuis ''mon_compte/connexion.php'', décrite [[#Connexion|plus haut]]. Cependant, la réponse XML contient quelques informations supplémentaires à propos des MP.
|-
|messages-prives/boite-reception_ws.php
|Permet de connaître le contenu de la boîte de réception. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/envoyes_ws.php
|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :
*''id_user'' : id de l'utilisateur
|-
|messages-prives/message_ws.php
| Permet de lire le contenu d'un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''nb_clic'' : le nombre de fois où l'utilisateur a cliqué sur « Voir les messages précédents »
*''last_position_message'' : Si ce paramètre vaut 0, les 5 derniers messages sont affichés. Sinon, les 10 messages les plus anciens en partant du ''x''ème sont affichés, la numérotation débutant à partir de 0.
|-
| messages-prives/nouveau_ws.php
|Permet d'envoyer un nouveau message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''all_dest'' : les destinataires, séparés pas des point-virgules
*''sujet'' : le titre du MP
*''yournewmessage'' : le contenu du MP
*''tmp'' : le timestamp actuel
*''control'' : md5("k_ys4+a]x" + idUtilisateur + "j6A=d?6-W*-" + timestamp + "z_.Im")
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/repondre_ws.php
|Permet de répondre à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''yournewmessage'' : le contenu du message
*''tmp'' : le timestamp actuel
* ''control'' : md5("vx*96-dP" + timestamp + "8e63ddO_" + idUtilisateur + "al)orc9W")
*''box'' : 1
Il se peut également que vous ayez à gérer un code de confirmation.
|-
|messages-prives/suggest_pseudo_ws.php
|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''search'' : ce que l'utilisateur est en train de taper
|-
|messages-prives/indesirable_ws.php
|Liste les utilisateurs ajoutés en indésirable. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
|-
|messages-prives/add_indesirable_ws.php
|Permet d'ajouter un utilisateur dans les indésirables. Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur actuel
*''pseudo'' : pseudo de l'utilisateur
*''id_user_indesirable'' : id de l'utilisateur à ajouter en indésirable
*''pseudo_indesirable'' : pseudo de l'utilisateur à ajouter en indésirable
*''time_indesirable'' : le timestamp actuel
*''key_indesirable'' : md5("5d*" + timestamp + "v1S{" + idIndesirable + "I,5|S9z)" + pseudoIndesirable + "52Sx69,")
|-
|messages-prives/del_indesirable_ws.php
|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur actuel
* ''id_user_indesirable'' : id de l'utilisateur à enlever des indésirables
|-
|messages-prives/info_alerte_ws.php
|Permet de connaître les informations qui permettront de faire une DDB ou une mise en indésirable sur un message. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
* ''id_message'' : id du message concerné
|-
|messages-prives/alerte_ws.php
| Permet d'effectuer une DDB (ce qui est inutile, étant donné qu'elles ne sont jamais traitées). Certaines données nécessaires pour former la requête doivent être récupérés avec info_alerte_ws.php. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur qui fait la DDB
*''pseudo'' : pseudo de l'utilisateur
*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)
*''id_message'' : id du message concerné
*''id_discussion'' : id de la discussion concernée
*''time_alerte'' : timestamp actuel
*''key_alerte'' : md5("v6dE{" + idDiscussion + "d96/" + idMessage + "mvn85Qa" + timestamp + "auxarmeheuuuuuuu")
|-
|messages-prives/connexion_valid_ws.php
|Permet d'afficher le nombre de messages non-lus ainsi que l'URL de l'avatar. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''pseudo'' : pseudo de l'utilisateur
|-
|messages-prives/add_destinataire_ws.php
|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :
*''id_user'' : id de l'utilisateur
*''id_discussion'' : id de la discussion
*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule
|-
|messages-prives/del_message_ws.php
|Permet de supprimer un message privé. Paramètres à envoyer :
* ''id_user'' : id de l'utilisateur
*''del_discussion'' : id des discussions à supprimer séparés par un tiret
*''box'' : 1
|}

== Ancienne rétro-ingéniérie ==
===Décompilation===
Cette section concerne la décompilation de l'application Android de JVC sous Linux.

Pour décompiler l'application JVC, commencez par récupérer le fichier APK [http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk ici] (version 2.5). Ensuite, décompressez-le avec 7-Zip :

$ 7z x com.jeuxvideo-2.5.apk

Puis, transformez le .dex en .jar à l'aide de l'utilitaire [http://code.google.com/p/dex2jar/downloads/list dex2jar] :

$ dex2jar classes.dex

Ensuite, vous pouvez ouvrir le .jar dans [http://java.decompiler.free.fr/?q=jdgui jd-gui], qui s'occupera de décompiler les fichiers :

$ jd-gui classes-dex2jar.jar

===Déobfuscation===
En parcourant le code source, vous verrez des choses de ce genre à la place des chaînes de caractères :

this.g.getString(2131230723)

Cela correspond à des chaînes de caractères stockées dans un fichier séparé, ''resources.arsc''. Pour en extraire le contenu, nous allons utiliser l'utilitaire [http://code.google.com/p/android-apktool/ apktool] :

$ apktool d com.jeuxvideo-2.5.apk strings

Ensuite, vous pourrez trouver dans le fichier ''strings/res/values/strings.xml'' la liste des chaînes de caractères associées à leurs variables, et dans ''strings/res/values/public.xml'', la liste des variables associées aux nombres (en hexadécimal) comme ''2131230723'' que vous voyez dans le code décompilé. Ce n'est pas très pratique mais je n'ai pas trouvé d'outil qui modifie directement le code décompilé pour y intégrer les valeurs du ''resources.arsc'' (mais je n'ai pas beaucoup cherché non plus).

Ce n'est pas tout. À partir de la version 2.0.3 de l'application JVC, et pour toutes les version de l'application JVC MP, vous pourrez également voir dans le fichier strings.xml des variables telles que :

<string name="md5_a">290B2FB20CFD682C120BBBFFFE5928D9</string>

Ces chaînes de caractères (des URL et quelques salts) sont obfusquées. Après avoir lu un peu de code, j'ai trouvé comment les restituer. Voici un bout de Python qui montre comment faire :

from Crypto.Cipher import AES
from passlib.utils.pbkdf2 import pbkdf2

cle = 'package android.content'
cle = AES.new(pbkdf2(cle, cle, 10, 128/8, 'hmac-sha1'))

string = '290B2FB20CFD682C120BBBFFFE5928D9'
string = cle.decrypt(string.decode('hex'))
print repr(string[:-ord(string[-1])])

Modifiez la clé selon l'application que vous décompilez:

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''
*Pour l'application Jeuxvideo.com (version >= 2.5), c'est ''package android.content''
*Pour l'application Jeuxvideo.com MP (version >= 1.0), c'est ''package com.jeuxvideomp.activity''

L'application pour tablettes n'est pas concernée par ce mécanisme d'obfuscation.

==Liens externes==
*[https://fr.wikipedia.org/wiki/Interface_de_programmation API sur Wikipédia]
*[http://www.jeuxvideo.com/forums/1-1000021-1691093-1-0-1-0-documentation-de-l-api-de-jeuxvideo-com.htm Lien du topic sur JVC pour poser vos questions]
*[https://play.google.com/store/apps/details?id=com.jeuxvideo&hl=fr L'application Android]
*[https://play.google.com/store/apps/details?id=com.jeuxvideomp&hl=fr L'application Android des MP]
*[https://itunes.apple.com/fr/app/id393077232 L'application iPhone]
*[https://itunes.apple.com/fr/app/id547233024 L'application iPhone des MP]

*L'APK de l'application Android :
**[http://pool.apk.aptoide.com/outstore/com-jeuxvideo-7-604082-50bec6ac892f7a0868936f6a1478de7d.apk Version 1.5.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/04/com.jeuxvideo-9.apk Version 2.0.1]
**[http://www.app-android-free.com/wp-content/uploads/2012/08/Jeuxvideo.com-2.0.4.apk Version 2.0.4]
**[http://android-applications-gratuites.com/wp-content/uploads/2012/09/com.jeuxvideo-13.apk Version 2.0.5]
**[http://pool.apk.aptoide.com/el-bucho/com-jeuxvideo-15-1700633-aebd47783deaffd1cead7c788d49c824.apk Version 2.1.1]
**[http://pool.apk.aptoide.com/cuvelier/com-jeuxvideo-17-2741356-e85ee96f02f8d4db3d178c7d85cd8157.apk Version 2.2]
**[http://android-applications-gratuites.com/wp-content/uploads/2013/03/com.jeuxvideo.apk Version 2.3]
**[http://painarguer.alwaysdata.net/com.jeuxvideo-2.5.apk Version 2.5]

*L'APK de l'application Android des MP :
**[http://android-applications-gratuites.com/wp-content/uploads/2012/10/com.jeuxvideomp-1.apk Version 1.0]

*L'APK de l'application Android tablette :
**[http://dl3.apk-dl.com/root/apk/2015/9/19/com.jeuxvideo.tablet_40.apk?f=Jeuxvideo.com%20tablette_1.0.4_apk-dl.com.apk Version 1.0.4]
{{SectionRéférences}}
{{TableauCatégorieFonctionnementJVC}}

[[Catégorie:Fonctionnement technique de Jeuxvideo.com]]
[[Catégorie:Extensions et outils]]

Fichier:icon2.png

2024-05-19T07:37:45Z

HelloWorld5000 : Fichier téléversé avec MsUpload

Fichier téléversé avec MsUpload