Pomoc API MediaWiki

To jest automatycznie wygenerowana strona dokumentacji API MediaWiki.

Dokumentacja i przykłady: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

prop=revisions (rv)

(main | query | revisions)
  • Ten moduł wymaga praw odczytu.
  • Ten moduł może być użyty jako generator.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Pozyskaj informacje o wersji.

May be used in several ways:

  1. Get data about a set of pages (last revision), by setting titles or pageids.
  2. Get revisions for one given page, by using titles or pageids with start, end, or limit.
  3. Get data about a set of revisions by setting their IDs with revids.
Parametry:
rvprop

Which properties to get for each revision:

ids
Identyfikator wersji.
flags
Znaczniki wersji (drobne).
timestamp
Znacznik czasu wersji.
user
Użytkownik, który utworzył wersję. Jeśli użytkownik został trwale usunięty (revision delete), zwrócona zostanie właściwość userhidden.
userid
User ID of the revision creator. If the user has been revision deleted, a userhidden property will be returned.
size
Długość wersji (w bajtach).
slotsize
Length (bytes) of each revision slot.
sha1
SHA-1 (base 16) wersji. Jeśli treść została trwale usunięta (revision delete), zwrócona zostanie właściwość sha1hidden.
slotsha1
SHA-1 (base 16) of each revision slot. If the content has been revision deleted, a sha1hidden property will be returned.
contentmodel
Content model ID of each revision slot.
comment
Comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
parsedcomment
Parsed comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
content
Tekst wersji. Jeśli treść została trwale usunięta (revision delete), zwrócona zostanie właściwość texthidden.
tags
Znaczniki wersji.
roles
List content slot roles that exist in the revision.
parsetree
Przestarzałe. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model wikitext).
Wartości (oddziel za pomocą | lub alternatywy): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
Domyślnie: ids|timestamp|flags|comment|user
rvslots

Which revision slots to return data for, when slot-related properties are included in rvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.

Wartości (oddziel za pomocą | lub alternatywy): main
Aby wskazać wszystkie wartości, użyj *.
rvlimit

Ograniczenie na liczbę wersji, które będą zwrócone.

May only be used with a single page (mode #2).
Type: integer or max
Wartość musi znajdować się pomiędzy 1 a 500.
rvexpandtemplates
Przestarzałe.

Use action=expandtemplates instead. Expand templates in revision content (requires rvprop=content).

Type: boolean (details)
rvgeneratexml
Przestarzałe.

Use action=expandtemplates or action=parse instead. Generate XML parse tree for revision content (requires rvprop=content).

Type: boolean (details)
rvparse
Przestarzałe.

Use action=parse instead. Parse revision content (requires rvprop=content). For performance reasons, if this option is used, rvlimit is enforced to 1.

Type: boolean (details)
rvsection

Only retrieve the content of the section with this identifier.

rvdiffto
Przestarzałe.

Use action=compare instead. Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.

rvdifftotext
Przestarzałe.

Use action=compare instead. Text to diff each revision to. Only diffs a limited number of revisions. Overrides rvdiffto. If rvsection is set, only that section will be diffed against this text.

rvdifftotextpst
Przestarzałe.

Use action=compare instead. Perform a pre-save transform on the text before diffing it. Only valid when used with rvdifftotext.

Type: boolean (details)
rvcontentformat
Przestarzałe.

Serialization format used for rvdifftotext and expected for output of content.

Jedna z następujących wartości: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
rvstartid

Start enumeration from this revision's timestamp. The revision must exist, but need not belong to this page.

May only be used with a single page (mode #2).
Typ: liczba całkowita
rvendid

Stop enumeration at this revision's timestamp. The revision must exist, but need not belong to this page.

May only be used with a single page (mode #2).
Typ: liczba całkowita
rvstart

From which revision timestamp to start enumeration.

May only be used with a single page (mode #2).
Typ: znacznik czasu (dozwolone formaty)
rvend

Enumerate up to this timestamp.

May only be used with a single page (mode #2).
Typ: znacznik czasu (dozwolone formaty)
rvdir

Kolejność wyliczania:

newer
Wymieniaj najpierw starsze wpisy. Uwaga: rvstart musi być przed rvend.
older
Wymieniaj najpierw nowsze wpisy (domyślnie). Uwaga: rvstart musi być po rvend.
May only be used with a single page (mode #2).
Jedna z następujących wartości: newer, older
Domyślnie: older
rvuser

Only include revisions made by user.

May only be used with a single page (mode #2).
Typ: użytkownik, podany jako: nazwa użytkownika, IP, nazwa interwiki (np. „prefiks>PrzykładowaNazwa”) oraz ID użytkownika (np. „#12345”)
rvexcludeuser

Exclude revisions made by user.

May only be used with a single page (mode #2).
Typ: użytkownik, podany jako: nazwa użytkownika, IP, nazwa interwiki (np. „prefiks>PrzykładowaNazwa”) oraz ID użytkownika (np. „#12345”)
rvtag

Only list revisions tagged with this tag.

rvcontinue

Gdy będzie dostępnych więcej wyników, użyj tego do kontynuowania.

Przykłady:
Get data with content for the last revision of titles API and Main Page.
api.php?action=query&prop=revisions&titles=API|Main%20Page&rvslots=*&rvprop=timestamp|user|comment|content [otwórz w brudnopisie]
Get last 5 revisions of the Main Page.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [otwórz w brudnopisie]
Get first 5 revisions of the Main Page.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [otwórz w brudnopisie]
Get first 5 revisions of the Main Page made after 2006-05-01.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [otwórz w brudnopisie]
Get first 5 revisions of the Main Page that were not made by anonymous user 127.0.0.1.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [otwórz w brudnopisie]
Get first 5 revisions of the Main Page that were made by the user MediaWiki default.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [otwórz w brudnopisie]
Źródło: „https://almanach.historyczny.org/wiki/Specjalna:ApiHelp”