Kheys
380
modifications
« Documentation de l'API Jeuxvideo.com » : différence entre les versions
→Endpoints
| Ligne 969 : | Ligne 969 : | ||
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>. | 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 | 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 === | === Queries des news === | ||
| Ligne 987 : | Ligne 985 : | ||
Notez que le ''query editorialRatingRange'' doit être encodé au format URL avant d'être envoyé. | 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înde ''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 === | === Liste des endpoints connus === | ||
| Ligne 1 047 : | Ligne 1 058 : | ||
'''limit''' int | '''limit''' int | ||
|Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''. | |Renvoie la liste des actualités triées par date de publication croissante et satisfaisant les ''queries''. | ||
|- | |- | ||
|reviews/datePublished.desc | |reviews/datePublished.desc | ||
| Ligne 1 089 : | Ligne 1 094 : | ||
'''limit''' int | '''limit''' int | ||
|Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''. | |Renvoie la liste des tests triés par nom croissant du jeu et satisfaisant les ''queries''. | ||
|- | |||
|previews/datePublished.desc | |||
| | |||
|'''platform''' str <br> | |||
'''gameGenre''' str <br> | |||
'''event''' str <br> | |||
'''offset''' int <br> | |||
'''limit''' int | |||
|Renvoie la liste des annonces triées par date de publication croissante et satisfaisant les ''queries''. | |||
|- | |- | ||
|topics/datePublished.desc | |topics/datePublished.desc | ||
| Ligne 1 098 : | Ligne 1 112 : | ||
|videos/datePublished.desc | |videos/datePublished.desc | ||
| | | | ||
| '''offset''' int <br> | |'''publicationType''' str <br> | ||
'''platform''' str <br> | |||
'''gameGenre''' str <br> | |||
'''event''' str <br> | |||
'''offset''' int <br> | |||
'''limit''' int | '''limit''' int | ||
|Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''. | |Renvoie la liste des vidéos triées par date de publication croissante et satisfaisant les ''queries''. | ||