Aide de l’API MediaWiki
Ceci est une page d’aide de l’API de MediaWiki générée automatiquement.
Documentation et exemples : https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
meta=readinglists (rl)
- Ce module est interne ou instable. Son fonctionnement peut être modifié sans préavis.
- Ce module nécessite des droits de lecture.
- Source : ReadingLists
- Licence : GPL-2.0-or-later
Lister ou filtrer les listes de lecture de l’utilisateur et afficher leur métadonnées.
Ce module a quatre modes d’opération. Avec le paramètre rllist, il renvoie des informations sur la liste spécifiée. Avec le paramètre rlchangedsince, il retourne toutes les listes de l’utilisateur actuel qui ont été changées depuis la date donnée (ceci sert à la synchronisation des appareils et, contrairement aux autres modes, inclue les listes supprimées. Seuls les changements des métadonnées des listes sont pris en compte, et non pas les modifications des éléments des listes). Avec les paramètres rlproject et rltitle, il renvoie toutes les listes qui incluent cette page. Sans aucun de ces paramètres, il renvoie toutes les listes.
- rllist
Identifiant de la liste.
- Type: entier
- La valeur ne peut pas être inférieure à 1.
- rlproject
Projet de la page à filtrer. Doit être utilisé avec rltitle. Ne renverra que les listes qui incluent ce projet et ce titre.
- rltitle
Titre de la page sur lequel appliquer le filtre. Doit être utilisé avec rlproject. Ne renverra que les listes qui incluent ce projet et ce titre.
- rlchangedsince
Afficher les listes qui ont été modifiées depuis cet horodatage. Doit être postérieur à 2024-05-02T14:56:18Z. Les clients doivent utiliser l’horodatage renvoyé dans le champ readinglists-synctimestamp lors d’un appel précédent s’ils veulent s’assurer qu’aucune modification ne manque et doivent se préparer à recevoir des modifications qui ont déjà été renvoyées dans une réponse précédente et les traiter de la même façon.
- Type : horodatage (formats autorisés)
- rlsort
Propriété selon laquelle trier. Ignoré quand rlproject et rltitle sont positionnés (les résultats sont renvoyés dans l’ordre de la base de données). Par défaut, updated quand rlchangedsince est positionné, et name autrement.
- name
- Nom de la liste (le tri est par valeur binaire ; par ex. tout caractère ASCII majuscule sera trié avant tout caractère minuscule).
- updated
- Horodatage de la dernière mise à jour (les mises à jour incluent les modifications des métadonnées de la liste, mais pas les modifications des éléments de la liste).
- Une des valeurs suivantes : name, updated
- rldir
Direction de tri : ascending (A à Z, du plus ancien au plus récent) ou descending. Ignoré quand rlproject et rltitle sont positionnés.
- Une des valeurs suivantes : ascending, descending
- Par défaut : ascending
- rllimit
Nombre d’éléments de résultats à retourner.
- Type : entier ou max
- La valeur doit être entre 1 et 10.
- Par défaut : 10
- rlcontinue
Quand plus de résultats sont disponibles, utilisez ceci pour continuer. Des informations plus détaillées sur la façon de continuer les requêtes peuvent être trouvées sur mediawiki.org.
- Obtenir les listes de lecture de l’utilisateur actuel.
- api.php?action=query&meta=readinglists [ouvrir dans le bac à sable]
- Obtenir les listes de lecture de l’utilisateur actuel qui ont changé depuis le 2013-01-01T00:00:00Z.
- api.php?action=query&meta=readinglists&rlchangedsince=2013-01-01T00:00:00Z [ouvrir dans le bac à sable]
- Obtenir les listes de lecture de l’utilisateur actuel qui contiennent la page Dog du projet en.wikipedia.org
- api.php?action=query&meta=readinglists&rlproject=https%3A%2F%2Fen.wikipedia.org&rltitle=Dog [ouvrir dans le bac à sable]