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

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.

<pre>

"Jvc-Authorization " : "header"

"Content-Type" : "application/json"

</pre>

'''Voici un script [https://www.python.org/ python] qui construit "''header''"'''

print(authorizationHeader)

</pre>

|+POST

!NOM

!URL

!BODY

|-

|addComment

|'''contentID''' str

|<pre>"content": "commentaire"</pre>

|-

|addCommentVote

'''commentID''' str

|<pre>"type": 1 ou -1</pre>

|-

|addFavorisGames

|accounts/{accountId}/favorites/games

|<pre>"games": [{

     "id": 1,

]}

</pre>

|-

|addReply

'''commentID''' str

|"content": "Super jeu !"

|-

|addReview

|'''id''' int

'''machine''' str  

"onProfile": true

</pre>

|-

|accounts/login

|

"password": "mot_de_passe"

|-

|logout

|

|

|-

|accounts/register  

''l'<nowiki/>'''Header''' doit inclure'' : "Jvc-Auth-Token" : str

"optin": false

</pre>

|-

|accounts/reset

|

        "val2" ]}

</pre>

|-

|reportAccount

"message": "Raison"

|-

|contents/{contentID}/comments/{commentID}/report

|'''contentID''' str

|<pre>"reason": 1,

"message": "Raison",

}

</pre>

|-

|reportReview

     "valeur_captcha": ""

}</pre>

|-

|restoreComment

'''commentID''' str

|"content" : "comment"

|-

|validateAccount

"password": "mdp"

</pre>

|-

|validateSignature

"signed_data": "signed_data"

</pre>

|}

|+GET

!NOM

!URL

!PARAMS

|-

|config

|

|

|-

|getAccount

|'''accountId''' str

|

|-

|getAllFavorisGames

|'''accountId''' str

|

|-

|getArticle

|'''id''' int

|

|-

|getArticleList

'''perPage''' int

'''types''' str

|-

|getCaptcha

|

|'''nb''' int

|-

|getChroniclesSummary

|

|'''machines''' str

|-

|getComment

'''commentID''' str

|

|-

|getCommentAnswers

'''commentID''' str

|

|-

|getComments

|'''page''' int

'''perPage''' int

|-

|getContentBean

|contents/{id}

|'''id''' int

|

|-

'''page''' int

'''perPage''' int

|-

|getCurrentAccountReport

|accounts/{accountId}/report

|'''accountId''' str

|

|-

'''commentID''' str

|

|-

|getCurrentReviewReport

'''reviewId''' int

|

|-

|getFavoris

|'''accountId''' str

|

|-

|getFavorisForum

|'''page''' int

'''perPage''' int

|-

|getFavorisGames

|'''accountId''' str

|

|-

|getFavorisTopics

|'''page''' int

'''perPage''' int

|-

|getFolder

|contents/{id}

|

|-

|getGame

'''machine''' str

|

|-

|games/{id}/{machine}/details

|'''id''' int

'''machine''' str

|

|-

|getGameImages

|'''page''' int

'''perPage''' int

|-

|getGameList

'''page''' int

'''perPage''' int

|-

|getGameNews

|'''page''' int

'''perPage''' int

|-

|getGameReleaseList

|

'''year''' str

'''machines''' str

'''page''' int

'''perPage''' int

|-

|getGameReview

'''review''' str

|

|-

|getGameReviews

|'''id''' int

|

|-

|getGameReviews

'''machine''' str

|

|-

|contents/games

|

|'''machines''' str

|-

|getGameUserReviews

|'''page''' int

'''perPage''' int

|-

|getGameVideos

|'''id''' int

'''machine''' str

|'''page''' int

'''perPage''' int

|-

|getGameWikis

|'''page''' int

'''perPage''' int

|-

|getHeadlineList

|

|'''machines''' str

'''page''' int

'''perPage''' int

|-

|contents/hightech

|

|'''machines''' str

|-

|getLightGame

'''machine''' str

|

|-

|getNews

|'''id''' int

|

|-

|getNewsHighTech

|'''page''' int

'''perPage''' int

|-

|accounts/{accountId}/page/contents

|'''accountId''' str

|'''page''' int

'''perPage''' int

|-

|getPageReviews

|'''page''' int

'''perPage''' int

|-

|getProfile

|'''accountId''' str

|

|-

|getProfilePage

|'''accountId''' str

|

|-

|getRelatedNews

|'''page''' int

'''perPage''' int

|-

|getRelatedVideos

|'''page''' int

'''perPage''' int

|-

|getRelatedWikis

|'''page''' int

'''perPage''' int

|-

|getSpecificNews

|

|

|-

|getStores

'''machine''' str

|

|-

|getTechList

|'''page''' int

'''perPage''' int

|-

|getTopWikis

|

|

|-

|getTopsComments

|'''contentID''' str

|

|-

|getVideo

|'''id''' int

|

|-

|getVideoList

'''page''' int

'''perPage''' int

|-

|getVideosSummary

|contents/videos

|

|-

|search

|

|'''q''' str

|-

|searchArticles

'''page''' int

'''perPage''' int

|-

|searchAutocomplete

|

|'''q''' str

|-

|searchGames

'''page''' int

'''perPage''' int

|-

|searchNews

'''page''' int

'''perPage''' int

|-

|searchVideos

'''page''' int

'''perPage''' int

|-

|searchWikis

|

|'''q''' str

'''page''' int

'''perPage''' int

|-

|sponso

|

|

|}

|+PUT

!NOM

!PARAMS

!BODY

|-

|saveDescription

|

|''rétro-ingénierie à faire''

|-

|saveExcludedMachines

|

|"machines" : [1, 2, 3, 4]  // id des machines

|-

|saveMachines

|

|"machines" : [1, 2, 3, 4]  // id des machines

|-

|contents/{contentID}/comments/{commentID}

|'''contentID''' str

'''commentID''' str

|"content": "Super jeu !"

|-

|accounts/me/avatar

|

|''rétro-ingénierie à faire''

|-

|uploadCover

|

|''rétro-ingénierie à faire''

|}

!NOM

!URL

!PARAMS

|-

|contents/{contentID}/comments/{commentID}

|'''contentID''' str

'''commentID''' str

|-

|deleteCommentVote

|'''contentID''' str

'''commentID''' str

|}

|+CUSTOM HTTP (''rétro-ingénierie à faire'')

!URL

!PARAMS

|-

|'''accountId''' str

|-

|accounts/{accountId}/favorites/games

|'''accountId''' str

|-

|accounts/{accountId}/favorites/topics

|'''accountId''' str

|}

Une fois le code Java disponible, on peut ouvrir l'interface ''com.jeuxvideo.api.web.'''JvApiService''''', qui contient tous les endpoints. L'appli utilise le bibliothèque [https://square.github.io/retrofit/ Retrofit 2.x] pour gérer l'API, on peut facilement parcourir la documentation de cette bibliothèque pour découvrir ce qu'il faut faire comme requête aux différentes URL de l'API.

</pre>

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).

! scope="col" |Mot de passe

|-

|e32!cdf

|-

! scope="row" |Android 2.0.3

|-

|-

! scope="row" |Android MP

|LXnb45=d#

|-

|nex12sz

|-

! scope="row" |iPhone

|W!P45-R

|-

|ip45de

|XpD5!FT

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

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

|Le pseudo de l'utilisateur.

|-

|Le timestamp (le nombre de secondes depuis le 1er janvier 1970) à l'heure où la requête est envoyée.

|-

|-

|02.news/''1234''.xml<br>02.news_screen/''1234''.xml

|-

|ean.php?ean=''0045496830144''

|Voir le jeu associé au code-barre (EAN) 0045496830144

|-

|Liste des forums généraux

|-

|search_n/''mario''<br>search/''mario''<br>search_sug/''mario''<br>search_forums/''mario''<br>search_forums_sug/''mario''

|-

|tab_suggest_blocs.xml<br>tab_suggest_forums.xml

|-

|''À compléter''

|}

===Forums===

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

Par exemple :<br>

|-

|https://ws.jeuxvideo.com/forums/0-50-0-1-0-1-2-cactus.xml

|-

|https://ws.jeuxvideo.com/forums/1-50-1-1-0-1-0-0.xml

|-

|https://ws.jeuxvideo.com/forums/3-50-0-1-0-1-0-0.xml

|10 derniers messages d'un topic + formulaire

|-

| Formulaire de réponse à un topic

|-

|https://ws.jeuxvideo.com/cgi-bin/jvforums/forums.cgi

|-

|}

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.

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

{| class="wikitable alternance centre"

! scope="col" |Description

|-

|Dernière version de l'application, liste des consoles et des smileys, lien vers la charte, pub activée ou non

|-

|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 :

|-

|messages-prives/envoyes_ws.php

|Permet de connaître la liste des messages envoyés. Paramètre à envoyer :

|-

*''id_discussion'' : id de la discussion

*''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.

|-

*''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

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_discussion'' : id de la discussion

*''yournewmessage'' : le contenu du message

|messages-prives/suggest_pseudo_ws.php

|Liste quelques pseudos qui commencent par ce que l'utilisateur est en train de taper. Paramètres à envoyer :

*''search'' : ce que l'utilisateur est en train de taper

|-

|messages-prives/del_indesirable_ws.php

|Permet d'enlever un utilisateur des indésirables. Paramètres à envoyer :

|-

|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 :

|-

|messages-prives/alerte_ws.php

*''pseudo'' : pseudo de l'utilisateur

*''motif'' : le motif, par exemple ''Piratage'' (les mêmes motifs que dans les MP sur JVC normal)

|-

|messages-prives/connexion_valid_ws.php

*''pseudo'' : pseudo de l'utilisateur

|-

|messages-prives/add_destinataire_ws.php

|Permet d'ajouter un destinataire à un message privé. Paramètres à envoyer :

*''id_discussion'' : id de la discussion

*''tab_pseudo'' : liste des destinataires à ajouter, séparés par un point-virgule

  print repr(string[:-ord(string[-1])])

*Pour l'application Jeuxvideo.com (version >= 2.0.3), c'est ''package com.jeuxvideo.activity''

==Liens externes==

*[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]