Aller au contenu

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

Ligne 282 : Ligne 282 :
|'''topics''' <code>[74229153, 74229154]</code> // ID des topics
|'''topics''' <code>[74229153, 74229154]</code> // ID des topics
|}
|}
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"
{| class="wikitable"
|+GET
|+GET
Ligne 296 : Ligne 313 :
|getAccount
|getAccount
|accounts/{accountId}
|accounts/{accountId}
|'''accountId''' str
|'''accountId''' int
|
|
|-
|-
|getAllFavorisGames
|getAllFavorisGames
|accounts/{accountId}/favorites/games/all
|accounts/{accountId}/favorites/games/all
|'''accountId''' str
|'''accountId''' int
|
|
|-
|-
Ligne 328 : Ligne 345 :
|getComment
|getComment
|contents/{contentID}/comments/{commentID}
|contents/{contentID}/comments/{commentID}
|'''contentID''' str
|'''contentID''' int
'''commentID''' str
'''commentID''' int
|
|
|-
|-
|getCommentAnswers
|getCommentAnswers
|contents/{contentID}/comments/{commentID}/answers
|contents/{contentID}/comments/{commentID}/answers
|'''contentID''' str
|'''contentID''' int
'''commentID''' str
'''commentID''' int
|
|
|-
|-
|getComments
|getComments
|contents/{contentID}/comments
|contents/{contentID}/comments
|'''contentID''' str
|'''contentID''' int
|'''page''' int
|'''page''' int
'''perPage''' int
'''perPage''' int
Ligne 357 : Ligne 374 :
'''machines''' str
'''machines''' str
'''page''' int
'''page''' int
'''perPage''' int <br>
'''perPage''' int
Les str peuvent contenir plusieurs valeurs grâce à l'encodage URL (voir l'[[#Annexe | annexe]]).
|-
|-
|getCurrentAccountReport
|getCurrentAccountReport
|accounts/{accountId}/report
|accounts/{accountId}/report
|'''accountId''' str
|'''accountId''' int
|
|
|-
|-
|getCurrentCommentReport
|getCurrentCommentReport
|contents/{contentID}/comments/{commentID}/report
|contents/{contentID}/comments/{commentID}/report
|'''contentID''' str
|'''contentID''' int
'''commentID''' str
'''commentID''' int
|
|
|-
|-
Ligne 380 : Ligne 396 :
|getFavorites
|getFavorites
|accounts/{accountId}/favorites
|accounts/{accountId}/favorites
|'''accountId''' str
|'''accountId''' int
|
|
|-
|-
|getFavoritesForum
|getFavoritesForum
|accounts/{accountId}/favorites/forums
|accounts/{accountId}/favorites/forums
|'''accountId''' str
|'''accountId''' int
|'''page''' int
|'''page''' int
'''perPage''' int
'''perPage''' int
Ligne 391 : Ligne 407 :
|getFavoritesGames
|getFavoritesGames
|accounts/{accountId}/favorites/games  
|accounts/{accountId}/favorites/games  
|'''accountId''' str
|'''accountId''' int
|
|
|-
|-
|getFavoritesTopics
|getFavoritesTopics
|accounts/{accountId}/favorites/topics
|accounts/{accountId}/favorites/topics
|'''accountId''' str
|'''accountId''' int
|'''page''' int
|'''page''' int
'''perPage''' int
'''perPage''' int
Ligne 432 : Ligne 448 :
'''mode''' str
'''mode''' str
'''page''' int
'''page''' int
'''perPage''' int <br>
'''perPage''' int
Les str peuvent contenir plusieurs valeurs grâce à l'encodage URL (voir l'[[#Annexe | annexe]]).
|-
|-
|getGameNews
|getGameNews
Ligne 525 : Ligne 540 :
|getPageContents  
|getPageContents  
|accounts/{accountId}/page/contents
|accounts/{accountId}/page/contents
|'''accountId''' str
|'''accountId''' int
|'''page''' int
|'''page''' int
'''perPage''' int
'''perPage''' int
Ligne 531 : Ligne 546 :
|getPageReviews
|getPageReviews
|accounts/{accountId}/page/reviews
|accounts/{accountId}/page/reviews
|'''accountId''' str
|'''accountId''' int
|'''page''' int
|'''page''' int
'''perPage''' int
'''perPage''' int
Ligne 537 : Ligne 552 :
|getProfile
|getProfile
|accounts/{accountId}/profile
|accounts/{accountId}/profile
|'''accountId''' str
|'''accountId''' int
|
|
|-
|-
|getProfilePage
|getProfilePage
|accounts/{accountId}/page
|accounts/{accountId}/page
|'''accountId''' str
|'''accountId''' int
|
|
|-
|-
Ligne 587 : Ligne 602 :
|getTopsComments
|getTopsComments
|contents/{contentID}/comments/tops
|contents/{contentID}/comments/tops
|'''contentID''' str
|'''contentID''' int
|
|
|-
|-
Kheys
410

modifications