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

Documentation de l'API Jeuxvideo.com (modifier)

Version du 18 mai 2024 à 19:08

2 010 octets ajoutés , 18 mai

→‎Endpoints

VisuelWikicode

HelloWorld5000

Kheys

407

modifications

@@ Ligne 964 : / Ligne 964 : @@
 ** <code>releases</code> pour avoir la liste des jeux pas encore sortis.
-=== Les queries ===
+=== Queries des jeux ===
-Les ''queries'' renseignent souvent la plateforme, le genre et le mode du jeu. La liste complète des ''queries'' possibles pour ces trois catégories est disponible au format JSON [https://pastebin.com/1LGEibT8 ici].
+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].
-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].
 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>.
@@ Ligne 973 : / Ligne 972 : @@
 Enfin, 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é.
 === Liste des endpoints connus ===
@@ Ligne 990 : / Ligne 1 004 : @@
 '''offset''' int <br>
 '''limit''' int <br>
-'''release''' int ou str
+'''release''' str
 |Renvoie la liste des jeux de la catégorie <code>{gameCategory}</code> triés par popularité décroissante et satisfaisant les ''queries''.
 |-
@@ Ligne 1 000 : / Ligne 1 014 : @@
 '''offset''' int <br>
 '''limit''' int <br>
-'''release''' int ou str
+'''release''' str
 |Renvoie la liste des jeux tendances triés par note décroissante des rédacteurs JVC et satisfaisant les ''queries''.
 |-
@@ Ligne 1 010 : / Ligne 1 024 : @@
 '''offset''' int <br>
 '''limit''' int <br>
-'''release''' int ou str
+'''release''' str
 |Renvoie la liste des jeux attendus triés par date de sortie croissante et satisfaisant les ''queries''.
 |-
@@ Ligne 1 020 : / Ligne 1 034 : @@
 '''offset''' int <br>
 '''limit''' int <br>
-'''release''' int ou str
+'''release''' str
 |Renvoie la liste des jeux attendus triés par titre croissant et satisfaisant les ''queries''.
 |-
 |news/datePublished.desc
 |
-| '''offset''' int <br>
+| '''publicationType''' str <br>
-'''release''' int
+'''platform''' str <br>
+'''gameGenre''' str <br>
+'''event''' str <br>
+'''publicationPeriod''' str <br>
+'''offset''' int <br>
+'''limit''' int
 |Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''.
 |-
@@ Ligne 1 032 : / Ligne 1 051 : @@
 |
 | '''offset''' int <br>
-'''release''' int
+'''limit''' int
 |Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''.
 |-
 |reviews/datePublished.desc
 |
-| '''offset''' int <br>
+|
-'''release''' int
+'''platform''' str<br>
-|Renvoie la liste des revues triées par date de publication croissante et satisfaisant les ''queries''.
+'''gameGenre''' str<br>
+'''gameMode''' str<br>
+'''editorialRatingRange''' str<br>
+'''maxAge''' str <br>
+'''offset''' int <br>
+'''limit''' int
+|Renvoie la liste des tests triés par date de publication croissante et satisfaisant les ''queries''.
+|-
+|reviews/editorialRating.desc
+|
+|
+'''platform''' str<br>
+'''gameGenre''' str<br>
+'''gameMode''' str<br>
+'''editorialRatingRange''' str<br>
+'''maxAge''' str <br>
+'''offset''' int <br>
+'''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<br>
+'''gameGenre''' str<br>
+'''gameMode''' str<br>
+'''editorialRatingRange''' str<br>
+'''maxAge''' str <br>
+'''offset''' int <br>
+'''limit''' int
+|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''.
 |-
 |topics/datePublished.desc
 |
 | '''offset''' int <br>
-'''release''' int
+'''limit''' int
 |Renvoie la liste des articles triés par date de publication croissante et satisfaisant les ''queries''.
 |-
@@ Ligne 1 050 : / Ligne 1 099 : @@
 |
 | '''offset''' int <br>
-'''release''' : int
+'''limit''' int
 |Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''.
 |-