MediaWiki-API-hjelp

Dette er en automatisk generert MediaWiki-API-dokumentasjonsside.

Dokumentasjon og eksempler: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

meta=readinglists (rl)

(main | query | readinglists)
  • Denne modulen er intern eller ustabil, og du bør ikke bruke den. Hvordan den fungerer kan forandre seg uten forvarsel.
  • Denne modulen krever lesetilgang.
  • Kilde: ReadingLists
  • Lisens: GPL-2.0-or-later

Liste opp eller filtrer brukerens leselister og vis metadata om dem.

Denne modulen har fire operasjonsmoduser. Med parameteren rllist returnerer den informasjon om den gitte lista. Med parameteren rlchangedsince returnerer den alle listene til den gjeldende brukeren som har blitt endret siden den gitte datoen. (Dette er ment for å synkronisere enheter, og inkluderer i motsetning til de andre modusene slettede lister. Bare endringer til listenes metadata tas hensyn til, ikke endringer i listenes elementer.) Med parameterne rlproject og rltitle returnerer den alle lister som inkluderer den siden. Uten noen av disse parameterne returnerer den alle lister.

Spesifikke parametre:
Andre generelle parametre er tilgjengelige.
rllist

Liste-ID.

Type: heltall
Verdien må være mindre enn 1.
rlproject

Prosjektet til siden det skal filtreres på. Må brukes sammen med rltitle. Returnerer bare lister som inneholder dette prosjektet og denne tittelen.

rltitle

Tittelen til siden det skal filtreres på. Må brukes sammen med rlproject. Vil kun returnere lister som inkluderer dette prosjektet og denne tittelen.

rlchangedsince

Viser lister som har blitt endret siden dette tidsstempelet. Må være etter 2024-05-15T12:40:23Z. Klienter bør bruke tidsstempelet som ble returnert i feltet readinglists-synctimestamp i et tidligere kall hvis de ønsker at ingen endringer skal gås glipp av, og bør være forberedt på å motta endringer som allerede har blitt returnert i en tidligere respons og behandle dem på en idempotent måte.

Type: tidsstempel (tillatte formater)
rlsort

Egenskapen det skal sorteres på. Ignoreres når rlproject og rltitle er satt (resultatene returneres i databasens rekkefølge). Standard er updated når rlchangedsince er satt, og name ellers.

name
Listenavn. (Sortering er en binær verdi; derfor vil store bokstaver sorteres før små bokstaver.)
updated
Siste tidsstempel for oppdatering. (Oppdateringer inkluderer endringer i listemetadata men ikke endringer i listeelementer.)
Én av følgende verdier: name, updated
rldir

Sorteringsrekkefølge: ascending (A til Z, eldst til nyest) eller descending. Ignoreres når rlproject og rltitle er satt.

Én av følgende verdier: ascending, descending
Standard: ascending
rllimit

Antall resultatelementer som skal returneres.

Type: heltall eller max
Verdien må være mellom 1 og 10.
Standard: 10
rlcontinue

Når flere resultater er tilgjengelige, bruk denne for å fortsette. Mer detaljert informasjon om hvordan man kan fortsette spørringer finnes på mediawiki.org.

Eksempler:
Hent leselister for den gjeldende brukeren.
api.php?action=query&meta=readinglists [åpne i sandkasse]
Hent leselister for den gjeldende brukere som har blitt endret siden 2013-01-01T00:00:00Z.
api.php?action=query&meta=readinglists&rlchangedsince=2013-01-01T00:00:00Z [åpne i sandkasse]
Hent leselistene til den gjeldende brukeren som inneholder siden Dog fra prosjektet en.wikipedia.org
api.php?action=query&meta=readinglists&rlproject=https%3A%2F%2Fen.wikipedia.org&rltitle=Dog [åpne i sandkasse]