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

Moduł główny

Stan: API MediaWiki jest ugruntowanym i stabilnym interfejsem, który jest aktywnie wspierany i ulepszany. Mimo iż staramy się tego unikać, czasami mogą mieć miejsce drastyczne zmiany; subskrybuj listę dyskusyjną mediawiki-api-announce, aby być na bieżąco ze zmianami.

Błędne żądania: Gdy zostanie wysłane błędne żądanie do API, zostanie wysłany w odpowiedzi nagłówek HTTP z kluczem „MediaWiki-API-Error” i zarówno jego wartość jak i wartość kodu błędu wysłanego w odpowiedzi będą miały taką samą wartość. Aby uzyskać więcej informacji, zobacz API: Błędy i ostrzeżenia.

Parametry:
action

Wybierz akcję do wykonania.

block
Zablokuj użytkownika.
changeauthenticationdata
Zmień dane logowania bieżącego użytkownika.
changecontentmodel
Zmień model zawartości strony
checktoken
Sprawdź poprawność tokenu z action=query&meta=tokens.
clearhasmsg
Czyści flagę hasmsg dla bieżącego użytkownika.
clientlogin
Zaloguj się na wiki używając interaktywnego flow.
compare
Pokaż porównanie dwóch stron.
createaccount
Utwórz nowe konto.
delete
Usuń stronę.
edit
Twórz i edytuj strony.
emailuser
Wyślij e‐mail do użytkownika.
expandtemplates
Rozwija wszystkie szablony zawarte w wikitekście.
feedcontributions
Zwraca kanał wkładu użytkownika.
feedrecentchanges
Zwraca kanał ostatnich zmian.
feedwatchlist
Zwraca kanał listy obserwowanych.
filerevert
Przywróć plik do starej wersji.
help
Wyświetl pomoc dla określonych modułów.
imagerotate
Obróć jeden lub wiecej obrazków.
import
Zaimportuj stronę z innej wiki, lub sformułuj plik XML.
linkaccount
Link an account from a third-party provider to the current user.
login
Zaloguj się i pobierz ciasteczka poświadczeń.
logout
Wyloguj i wyczyść dane sesji.
managetags
Wykonywanie zadań związanych z zarządzaniem znacznikami zmian.
mergehistory
Łączenie historii edycji.
move
Przenieś stronę.
opensearch
Przeszukaj wiki przy użyciu protokołu OpenSearch.
options
Zmienia preferencje bieżącego użytkownika.
paraminfo
Zdobądź informacje o modułach API.
parse
Parsuje treść i zwraca wynik pracy parsera.
patrol
Sprawdź stronę lub edycję.
protect
Zmień poziom zabezpieczenia strony.
purge
Wyczyść pamięć podręczną dla stron o podanych tytułach.
query
Pozyskuj dane z i o MediaWiki.
removeauthenticationdata
Usuń dane poświadczeń obecnego użytkownika.
resetpassword
Wyślij użytkownikowi e-mail do resetowania hasła.
revisiondelete
Usuwaj i przywracaj wersje.
rollback
Wycofaj ostatnią edycję na stronie.
rsd
Export an RSD (Really Simple Discovery) schema.
setnotificationtimestamp
Update the notification timestamp for watched pages.
setpagelanguage
Zmień język strony.
tag
Add or remove change tags from individual revisions or log entries.
unblock
Odblokuj użytkownika.
undelete
Odtwórz wersje usuniętej strony.
unlinkaccount
Remove a linked third-party account from the current user.
upload
Upload a file, or get the status of pending uploads.
userrights
Zmień przynależność użytkownika do grup.
validatepassword
Validate a password against the wiki's password policies.
watch
Dodaj strony do listy obserwowanych obecnego użytkownika lub usuń je z niej.
categorytree
Wewnętrzny. Wewnętrzny moduł rozszerzenia CategoryTree.
cspreport
Wewnętrzny. Used by browsers to report violations of the Content Security Policy. This module should never be used, except when used automatically by a CSP compliant web browser.
stashedit
Wewnętrzny. Prepare an edit in shared cache.
Jedna z następujących wartości: block, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, help, imagerotate, import, linkaccount, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, tag, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, categorytree, cspreport, stashedit
Domyślnie: help
format

Format danych wyjściowych.

json
Dane wyjściowe w formacie JSON.
jsonfm
Dane wyjściowe w formacie JSON (prawidłowo wyświetlane w HTML).
none
Output nothing.
php
Dane wyjściowe w serializowany formacie PHP.
phpfm
Dane wyjściowe w serializowanym formacie PHP (prawidłowo wyświetlane w HTML).
rawfm
Output data, including debugging elements, in JSON format (pretty-print in HTML).
xml
Dane wyjściowe w formacie XML.
xmlfm
Dane wyjściowe w formacie XML (prawidłowo wyświetlane w HTML).
Jedna z następujących wartości: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
Domyślnie: jsonfm
maxlag

Maksymalne opóźnienie mogą być używane kiedy MediaWiki jest zainstalowana w klastrze zreplikowanej bazy danych. By zapisać działania powodujące większe opóźnienie replikacji, ten parametr może wymusić czekanie u klienta, dopóki opóźnienie replikacji jest mniejsze niż określona wartość. W przypadku nadmiernego opóźnienia, kod błędu maxlag jest zwracany z wiadomością jak Oczekiwanie na $host: $lag sekund opóźnienia.
Zobacz Podręcznik:Parametr Maxlag by uzyskać więcej informacji.

Typ: liczba całkowita
smaxage

Ustaw nagłówek HTTP kontrolujący pamięć podręczną s-maxage na taką ilość sekund. Błędy nie będą nigdy przechowywane w pamięci podręcznej.

Typ: liczba całkowita
Domyślnie: 0
maxage

Ustaw nagłówek HTTP kontrolujący pamięć podręczną maxage na taką ilość sekund. Błędy nie będą nigdy przechowywane w pamięci podręcznej.

Typ: liczba całkowita
Domyślnie: 0
assert

Zweryfikuj, czy użytkownik jest zalogowany, jeżeli wybrano user, niezalogowany, jeżeli wybrano anon, lub czy ma uprawnienia bota, jeżeli wybrano bot.

Jedna z następujących wartości: anon, bot, user
assertuser

Sprawdź, czy bieżący użytkownik posiada nazwę.

Typ: użytkownik, podany jako: nazwa użytkownika
requestid

Każda wartość tu podana będzie dołączana do odpowiedzi. Może być użyta do rozróżniania żądań.

servedby

Dołącz do odpowiedzi nazwę hosta, który obsłużył żądanie.

Type: boolean (details)
curtimestamp

Dołącz obecny znacznik czasu do wyniku.

Type: boolean (details)
responselanginfo

Dołącz języki użyte w uselang i errorlang do wyniku.

Type: boolean (details)
origin

Łącząc się z API używając żądań AJAX z innej domeny internetowej (CORS) ustaw wartość tego parametru na domenę źródłową. Parametr ten musi być uwzględniony w każdym podstawowym żądaniu, toteż musi być częścią URI żądania (nie częścią żądania POST).

W uwierzytelnionych żądaniach wartość tego parametru musi dokładnie odpowiadać jednej ze źródłowych domen w nagłówku Origin, powinna więc pasować do wzoru https://en.wikipedia.org lub https://meta.wikimedia.org. Jeżeli parametr nie odpowiada nagłówkowi Origin, zwrócona zostanie odpowiedź z błędem 403. Jeżeli parametr odpowiada nagłówkowi Origin, a domena źródłowa należy do akceptowanych, ustawione zostaną nagłówki Access-Control-Allow-Origin oraz Access-Control-Allow-Credentials.

W nieuwierzytelnionych żądaniach podaj wartość *. Sprawi to, że ustawiony zostanie nagłówek Access-Control-Allow-Origin, jednak nagłówek Access-Control-Allow-Credentials otrzyma wartość false a wszelkie dane dotyczące użytkownika będą ograniczone.

uselang

Język, w którym mają być pokazywane tłumaczenia komunikatów. action=query&meta=siteinfo z siprop=languages zwróci listę języków lub ustaw jako user, aby pobrać z preferencji zalogowanego użytkownika lub content, aby wykorzystać język zawartości tej wiki.

Domyślnie: user
variant

Variant of the language. Only works if the base language supports variant conversion.

errorformat

Format tekstu ostrzeżeń i błędów

plaintext
Wikitekst z usuniętymi znacznikami HTML i zastąpionymi encjami.
wikitext
Nieprzeparsowany wikitekst.
html
HTML
raw
Klucz komunikatu i parametry.
none
Brak tekstu wyjściowego, tylko kody błędów.
bc
Format używany przed MediaWiki w wersji 1.29. Parametry errorlang oraz errorsuselocal są ignorowane.
Jedna z następujących wartości: bc, html, none, plaintext, raw, wikitext
Domyślnie: bc
errorlang

Język, w którym mają być pokazywane ostrzeżenia i błędy. action=query&meta=siteinfo z siprop=languages zwróci listę języków lub ustaw jako content, aby wykorzystać język zawartości tej wiki. Możesz też ustawić jako uselang, aby użyć tej samej wartości co parametr uselang.

Domyślnie: uselang
errorsuselocal

Jeśli podano, teksty błędów będą używały lokalnie zmodyfikowanych komunikatów z przestrzeni MediaWiki.

Type: boolean (details)
Przykłady:
Pomoc dla modułu głównego
api.php?action=help [otwórz w brudnopisie]
Cała pomoc na jednej stronie.
api.php?action=help&recursivesubmodules=1 [otwórz w brudnopisie]
Uprawnienia:
writeapi
Zapis poprzez interfejs API
Przydzielone dla: all, user oraz bot
apihighlimits
Użyj wyższych limitów w zapytaniach API (dla zapytań powolnych: 500; dla zapytań szybkich: 5000). Limity zapytań powolnych są także stosowane dla parametrów z podanymi wieloma wartościami.
Przydzielone dla: bot oraz sysop

action=block

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Zablokuj użytkownika.

Parametry:
user

Użytkownik, którego chcesz zablokować.

Typ: użytkownik, podany jako: nazwa użytkownika, IP, zakres IP oraz ID użytkownika (np. „#12345”)
userid
Przestarzałe.

Zamiast tego podaj parametr user=#ID.

Typ: liczba całkowita
expiry

Czas trwania. Może być względny (np. 5 months or 2 weeks) lub konkretny (np. 2014-09-18T12:34:56Z). Jeśli jest ustawiony na infinite, indefinite, lub never, blokada nigdy nie wygaśnie.

Domyślnie: never
reason

Powód blokady.

Domyślnie: (puste)
anononly

Blokuj tylko anonimowych użytkowników (blokuje anonimowe edycje z tego adresu IP).

Type: boolean (details)
nocreate

Zapobiegnij utworzeniu konta.

Type: boolean (details)
autoblock

Zablokuj ostatni adres IP tego użytkownika i automatycznie wszystkie kolejne, z których będzie się logował.

Type: boolean (details)
noemail

Uniemożliwia użytkownikowi wysyłanie wiadomości e-mail za pośrednictwem interfejsu wiki. (Wymagane uprawnienie blockemail).

Type: boolean (details)
hidename

Ukryj nazwę użytkownika z rejestru blokad. (Wymagane uprawnienie hideuser)

Type: boolean (details)
allowusertalk

Pozwala użytkownikowi edytować własną stronę dyskusji (zależy od $wgBlockAllowsUTEdit).

Type: boolean (details)
reblock

Jeżeli ten użytkownik jest już zablokowany, nadpisz blokadę.

Type: boolean (details)
watchuser

Obserwuj stronę użytkownika lub IP oraz ich strony dyskusji.

Type: boolean (details)
tags

Znaczniki do dodania przy wpisie w rejestrze.

Wartości (oddziel za pomocą | lub alternatywy):
partial

Zablokuj użytkownikowi dostęp do wybranych stron lub przestrzeni nazw zamiast do całej witryny.

Type: boolean (details)
pagerestrictions

Lista tytułów stron do zablokowania użytkownikowi możliwości edycji. Ma zastosowanie tylko gdy partial (częściowa) jest ustawione na true (prawda).

Typ: nazwa strony
Oddziel wartości za pomocą | lub alternatywy.
Maksymalna liczba wartości to 10.
Akceptowane są tylko istniejące strony.
namespacerestrictions

Lista ID przestrzeni nazw do zablokowania użytkownikowi możliwości edycji. Ma zastosowanie tylko gdy partial (częściowa) jest ustawione na true (prawda).

Wartości (oddziel za pomocą | lub alternatywy): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Aby wskazać wszystkie wartości, użyj *.
token

Token „csrf” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.
Przykłady:
Zablokuj IP 192.0.2.5 na 3 dni z powodem.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [otwórz w brudnopisie]
Zablokuj użytkownika Vandal na zawsze z powodem i uniemożliw utworzenie nowego konta oraz wysyłanie emaili.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [otwórz w brudnopisie]

action=categorytree

  • Ten moduł jest wewnętrzny lub niestabilny. Jego działanie może się zmienić bez uprzedzenia.
  • Ten moduł wymaga praw odczytu.
  • Źródło: CategoryTree
  • Licencja: GPL-2.0-or-later

Wewnętrzny moduł rozszerzenia CategoryTree.

Parametry:
category

Tytuł w przestrzeni nazw kategorii, prefiks będzie ignorowany jeżeli podany.

Ten parametr jest wymagany.
options

Opcje dla konstruktora CategoryTree w postaci obiektu JSON. Opcja depth domyślnie wynosi 1.

action=changeauthenticationdata (changeauth)

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Zmień dane logowania bieżącego użytkownika.

Parametry:
changeauthrequest

Użyj tego żądania poświadczeń za pośrednictwem id od action=query&meta=authmanagerinfo z amirequestsfor=change.

Ten parametr jest wymagany.
changeauthtoken

Token „csrf” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.
*
Ten moduł akceptuje dodatkowe parametry, w zależności od dostępnych żądań poświadczeń. Użyj action=query&meta=authmanagerinfo z amirequestsfor=change (lub poprzednią odpowiedzią tego modułu, jeśli dotyczy) aby określić dostępne żądania i pola, których używają.

action=changecontentmodel

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Zmień model zawartości strony

Parametry:
title

Tytuł strony do zmiany modelu zawartości. Nie używać wraz z pageid.

pageid

ID strony do zmiany modelu zawartości. Nie może być użyte wraz z title.

Typ: liczba całkowita
summary

Opis zmian i powód we wpisie rejestru

tags

Change tags to apply to the log entry and edit.

Wartości (oddziel za pomocą | lub alternatywy):
model

Model zawartości nowego tekstu.

Ten parametr jest wymagany.
Jedna z następujących wartości: css, javascript, json, text, wikitext
bot

Oznacz zmianę modelu zawartości flagą bota.

Type: boolean (details)
token

Token „csrf” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.

action=checktoken

Sprawdź poprawność tokenu z action=query&meta=tokens.

Parametry:
type

Typ tokenu do przetestowania.

Ten parametr jest wymagany.
Jedna z następujących wartości: createaccount, csrf, login, patrol, rollback, userrights, watch
token

Token do przetestowania.

Ten parametr jest wymagany.
maxtokenage

Maksymalny wiek tokenu, w sekundach.

Typ: liczba całkowita

action=clearhasmsg

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Czyści flagę hasmsg dla bieżącego użytkownika.

Przykład:
Wyczyść flagę hasmsg dla bieżącego użytkownika.
api.php?action=clearhasmsg [otwórz w brudnopisie]

action=clientlogin (login)

  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Zaloguj się na wiki używając interaktywnego flow.

The general procedure to use this module is:

  1. Fetch the fields available from action=query&meta=authmanagerinfo with amirequestsfor=login, and a login token from action=query&meta=tokens.
  2. Present the fields to the user, and obtain their submission.
  3. Post to this module, supplying loginreturnurl and any relevant fields.
  4. Check the status in the response.
    • If you received PASS or FAIL, you're done. The operation either succeeded or it didn't.
    • If you received UI, present the new fields to the user and obtain their submission. Then post to this module with logincontinue and the relevant fields set, and repeat step 4.
    • If you received REDIRECT, direct the user to the redirecttarget and wait for the return to loginreturnurl. Then post to this module with logincontinue and any fields passed to the return URL, and repeat step 4.
    • If you received RESTART, that means the authentication worked but we don't have a linked user account. You might treat this as UI or as FAIL.
Parametry:
loginrequests

Only use these authentication requests, by the id returned from action=query&meta=authmanagerinfo with amirequestsfor=login or from a previous response from this module.

Oddziel wartości za pomocą | lub alternatywy.
Maksymalna liczba wartości to 50 (500 dla klientów z podwyższonymi limitami).
loginmessageformat

Format to use for returning messages.

Jedna z następujących wartości: html, none, raw, wikitext
Domyślnie: wikitext
loginmergerequestfields

Merge field information for all authentication requests into one array.

Type: boolean (details)
loginpreservestate

Preserve state from a previous failed login attempt, if possible.

Type: boolean (details)
loginreturnurl

Return URL for third-party authentication flows, must be absolute. Either this or logincontinue is required.

Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a logincontinue request to this API module.

logincontinue

This request is a continuation after an earlier UI or REDIRECT response. Either this or loginreturnurl is required.

Type: boolean (details)
logintoken

Token „login” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.
*
Ten moduł akceptuje dodatkowe parametry, w zależności od dostępnych żądań poświadczeń. Użyj action=query&meta=authmanagerinfo z amirequestsfor=login (lub poprzednią odpowiedzią tego modułu, jeśli dotyczy) aby określić dostępne żądania i pola, których używają.
Przykłady:
Rozpocznij proces logowania się do wiki jako użytkownik Example z hasłem ExamplePassword.
api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [otwórz w brudnopisie]
Kontynuuj logowanie po prośbie od UI o weryfikację dwuetapową, dostarczając OATHToken o wartości 987654.
api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [otwórz w brudnopisie]

action=compare

Pokaż porównanie dwóch stron.

Numer wersji, tytuł strony, ID strony, tekst lub względne odniesienie dla parametrów „from” i „to” musi być zaliczone.

Parametry:
fromtitle

Pierwszy tytuł do porównania.

fromid

ID pierwszej strony do porównania.

Typ: liczba całkowita
fromrev

Pierwsza wersja do porównania.

Typ: liczba całkowita
fromslots

Nadpisz zawartość wersji podaną przez fromtitle, fromid lub fromrev.

Ten parametr określa sloty do zmodyfikowania. Użyj fromtext-{slot}, fromcontentmodel-{slot} oraz fromcontentformat-{slot} aby określić zawartość każdego slotu.

Wartości (oddziel za pomocą | lub alternatywy): main
fromtext-{slot}

Tekst wybranego slotu. Slot jest usunięty z wersji jeśli pominięto ten parametr.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of fromslots.
fromsection-{slot}

When fromtext-{slot} is the content of a single section, this is the section identifier. It will be merged into the revision specified by fromtitle, fromid or fromrev as if for a section edit.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of fromslots.
fromcontentformat-{slot}

Content serialization format of fromtext-{slot}.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of fromslots.
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
fromcontentmodel-{slot}

Content model of fromtext-{slot}. If not supplied, it will be guessed based on the other parameters.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of fromslots.
Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
frompst

Dokonaj zapisu wersji roboczej transformacji przeprowadzonej na fromtext-{slot}.

Type: boolean (details)
fromtext
Przestarzałe.

Specify fromslots=main and use fromtext-main instead.

fromcontentformat
Przestarzałe.

Specify fromslots=main and use fromcontentformat-main instead.

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
fromcontentmodel
Przestarzałe.

Specify fromslots=main and use fromcontentmodel-main instead.

Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
fromsection
Przestarzałe.

Only use the specified section of the specified 'from' content.

totitle

Drugi tytuł do porównania.

toid

Numer drugiej strony do porównania.

Typ: liczba całkowita
torev

Druga wersja do porównania.

Typ: liczba całkowita
torelative

Use a revision relative to the revision determined from fromtitle, fromid or fromrev. All of the other 'to' options will be ignored.

Jedna z następujących wartości: cur, next, prev
toslots

Override content of the revision specified by totitle, toid or torev.

This parameter specifies the slots that are to be modified. Use totext-{slot}, tocontentmodel-{slot}, and tocontentformat-{slot} to specify content for each slot.

Wartości (oddziel za pomocą | lub alternatywy): main
totext-{slot}

Text of the specified slot. If omitted, the slot is removed from the revision.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
tosection-{slot}

When totext-{slot} is the content of a single section, this is the section identifier. It will be merged into the revision specified by totitle, toid or torev as if for a section edit.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
tocontentformat-{slot}

Content serialization format of totext-{slot}.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
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
tocontentmodel-{slot}

Content model of totext-{slot}. If not supplied, it will be guessed based on the other parameters.

This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
topst

Do a pre-save transform on totext.

Type: boolean (details)
totext
Przestarzałe.

Specify toslots=main and use totext-main instead.

tocontentformat
Przestarzałe.

Specify toslots=main and use tocontentformat-main instead.

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
tocontentmodel
Przestarzałe.

Specify toslots=main and use tocontentmodel-main instead.

Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
tosection
Przestarzałe.

Only use the specified section of the specified 'to' content.

prop

Which pieces of information to get.

diff
The diff HTML.
diffsize
The size of the diff HTML, in bytes.
rel
The revision IDs of the revision previous to 'from' and after 'to', if any.
ids
The page and revision IDs of the 'from' and 'to' revisions.
title
The page titles of the 'from' and 'to' revisions.
user
The user name and ID of the 'from' and 'to' revisions. If the user has been revision deleted, a fromuserhidden or touserhidden property will be returned.
comment
The comment on the 'from' and 'to' revisions. If the comment has been revision deleted, a fromcommenthidden or tocommenthidden property will be returned.
parsedcomment
The parsed comment on the 'from' and 'to' revisions. If the comment has been revision deleted, a fromcommenthidden or tocommenthidden property will be returned.
size
The size of the 'from' and 'to' revisions.
timestamp
(bez opisu)
Wartości (oddziel za pomocą | lub alternatywy): comment, diff, diffsize, ids, parsedcomment, rel, size, timestamp, title, user
Domyślnie: diff|ids|title
slots

Return individual diffs for these slots, rather than one combined diff for all slots.

Wartości (oddziel za pomocą | lub alternatywy): main
Aby wskazać wszystkie wartości, użyj *.
Przykład:
Create a diff between revision 1 and 2.
api.php?action=compare&fromrev=1&torev=2 [otwórz w brudnopisie]

action=createaccount (create)

  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Utwórz nowe konto.

The general procedure to use this module is:

  1. Fetch the fields available from action=query&meta=authmanagerinfo with amirequestsfor=create, and a createaccount token from action=query&meta=tokens.
  2. Present the fields to the user, and obtain their submission.
  3. Post to this module, supplying createreturnurl and any relevant fields.
  4. Check the status in the response.
    • If you received PASS or FAIL, you're done. The operation either succeeded or it didn't.
    • If you received UI, present the new fields to the user and obtain their submission. Then post to this module with createcontinue and the relevant fields set, and repeat step 4.
    • If you received REDIRECT, direct the user to the redirecttarget and wait for the return to createreturnurl. Then post to this module with createcontinue and any fields passed to the return URL, and repeat step 4.
    • If you received RESTART, that means the authentication worked but we don't have a linked user account. You might treat this as UI or as FAIL.
Parametry:
createrequests

Only use these authentication requests, by the id returned from action=query&meta=authmanagerinfo with amirequestsfor=create or from a previous response from this module.

Oddziel wartości za pomocą | lub alternatywy.
Maksymalna liczba wartości to 50 (500 dla klientów z podwyższonymi limitami).
createmessageformat

Format to use for returning messages.

Jedna z następujących wartości: html, none, raw, wikitext
Domyślnie: wikitext
createmergerequestfields

Merge field information for all authentication requests into one array.

Type: boolean (details)
createpreservestate

Preserve state from a previous failed login attempt, if possible.

If action=query&meta=authmanagerinfo returned true for hasprimarypreservedstate, requests marked as primary-required should be omitted. If it returned a non-empty value for preservedusername, that username must be used for the username parameter.

Type: boolean (details)
createreturnurl

Return URL for third-party authentication flows, must be absolute. Either this or createcontinue is required.

Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a createcontinue request to this API module.

createcontinue

This request is a continuation after an earlier UI or REDIRECT response. Either this or createreturnurl is required.

Type: boolean (details)
createtoken

Token „createaccount” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.
*
Ten moduł akceptuje dodatkowe parametry, w zależności od dostępnych żądań poświadczeń. Użyj action=query&meta=authmanagerinfo z amirequestsfor=create (lub poprzednią odpowiedzią tego modułu, jeśli dotyczy) aby określić dostępne żądania i pola, których używają.

action=cspreport

  • Ten moduł jest wewnętrzny lub niestabilny. Jego działanie może się zmienić bez uprzedzenia.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Used by browsers to report violations of the Content Security Policy. This module should never be used, except when used automatically by a CSP compliant web browser.

Parametry:
reportonly

Mark as being a report from a monitoring policy, not an enforced policy

Type: boolean (details)
source

What generated the CSP header that triggered this report

Domyślnie: internal

action=delete

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Usuń stronę.

Parametry:
title

Tytuł strony do usunięcia. Nie używać wraz z pageid.

pageid

ID strony do usunięcia. Nie może być użyte wraz z title.

Typ: liczba całkowita
reason

Powód usuwania. Jeśli pozostawisz to pole puste, zostanie użyty powód wygenerowany automatycznie.

tags

Change tags to apply to the entry in the deletion log.

Wartości (oddziel za pomocą | lub alternatywy):
deletetalk

Delete the talk page, if it exists.

Type: boolean (details)
watch
Przestarzałe.

Dodaj stronę do obecnej listy obserwowanych.

Type: boolean (details)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.

Jedna z następujących wartości: nochange, preferences, unwatch, watch
Domyślnie: preferences
unwatch
Przestarzałe.

Usuń stronę z obecnej listy obserwowanych.

Type: boolean (details)
oldimage

The name of the old image to delete as provided by action=query&prop=imageinfo&iiprop=archivename.

token

Token „csrf” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.

action=edit

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Twórz i edytuj strony.

Parametry:
title

Tytuł strony do edycji. Nie może być użyty równocześnie z pageid.

pageid

ID strony do edycji. Nie może być używany równocześnie z title.

Typ: liczba całkowita
section

Identyfikator sekcji. 0 dla górnej sekcji, new dla nowej sekcji. Zazwyczaj dodatnia liczba całkowita, ale może też być wartością nienumeryczną.

sectiontitle

Tytuł nowej sekcji.

text

Zawartość strony.

summary

Opis edycji. Także tytuł sekcji gdy użyto section=new, a nie ustawiono sectiontitle.

tags

Znaczniki zmian do zastosowania w tej edycji.

Wartości (oddziel za pomocą | lub alternatywy):
minor

Oznacz tę zmianę jako drobną zmianę.

Type: boolean (details)
notminor

Nie oznaczaj tej zmiany jako drobną nawet jeśli ustawiona jest preferencja „Wszystkie edycje domyślnie oznaczaj jako drobne”.

Type: boolean (details)
bot

Oznacz tę edycję jako edycję bota.

Type: boolean (details)
baserevid

ID of the base revision, used to detect edit conflicts. May be obtained through action=query&prop=revisions. Self-conflicts cause the edit to fail unless basetimestamp is set.

Typ: liczba całkowita
basetimestamp

Czas wersji, która jest edytowana. Służy do wykrywania konfliktów edycji. Można pobrać poprzez action=query&prop=revisions&rvprop=timestamp. Konflikty z samym sobą są ignorowane.

Typ: znacznik czasu (dozwolone formaty)
starttimestamp

Czas rozpoczęcia procesu edycji. Służy do wykrywania konfliktów edycji. Odpowiednia wartość może być pobrana za pomocą curtimestamp podczas rozpoczynania procesu edycji (np. podczas ładowania zawartości strony do edycji).

Typ: znacznik czasu (dozwolone formaty)
recreate

Ignoruj błędy o usunięciu strony w międzyczasie.

Type: boolean (details)
createonly

Nie edytuj strony, jeśli już istnieje.

Type: boolean (details)
nocreate

Zwróć błąd, jeśli strona nie istnieje.

Type: boolean (details)
watch
Przestarzałe.

Dodaj stronę do listy obserwowanych bieżącego użytkownika.

Type: boolean (details)
unwatch
Przestarzałe.

Usuń stronę z listy obserwowanych bieżącego użytkownika.

Type: boolean (details)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.

Jedna z następujących wartości: nochange, preferences, unwatch, watch
Domyślnie: preferences
md5

Hash MD5 parametru text lub złączonych parametrów prependtext i appendtext. Jeżeli ustawiony, edycja nie zostanie zapisana dopóki hash nie będzie się zgadzać.

prependtext

Tekst do dodania na początku strony. Zastępuje text.

appendtext

Tekst do dodania na końcu strony. Zastępuje text.

Użyj section=new zamiast tego parametru aby dodać nową sekcję.

undo

Wycofaj tę wersję. Zastępuje text, prependtext i appendtext.

Typ: liczba całkowita
Wartość nie może być mniejsza niż 0.
undoafter

Wycofaj wszystkie wersje od undo do tej. Jeżeli nie ustawiono, wycofaj tylko jedną wersję.

Typ: liczba całkowita
Wartość nie może być mniejsza niż 0.
redirect

Automatycznie rozwiązuj przekierowania.

Type: boolean (details)
contentformat

Format serializacji zawartości wprowadzonego tekstu.

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
contentmodel

Model zawartości nowego tekstu.

Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
token

Token „csrf” pobrany z action=query&meta=tokens

Token powinien być wysyłany jako ostatni parametr albo przynajmniej po parametrze text.

Ten parametr jest wymagany.

action=emailuser

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Wyślij e‐mail do użytkownika.

Parametry:
target

Użytkownik, do którego wysłać e-mail.

Ten parametr jest wymagany.
subject

Nagłówek tematu.

text

Treść emaila.

Ten parametr jest wymagany.
ccme

Wyślij kopię wiadomości do mnie.

Type: boolean (details)
token

Token „csrf” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.
Przykład:
Wyślij e-mail do użytkownika WikiSysop z tekstem Content.
api.php?action=emailuser&target=WikiSysop&text=Content&token=123ABC [otwórz w brudnopisie]

action=expandtemplates

Rozwija wszystkie szablony zawarte w wikitekście.

Parametry:
title

Tytuł strony.

text

Wikitext do przekonwertowania.

Ten parametr jest wymagany.
revid

ID wersji, dla {{REVISIONID}} i podobnych zmiennych.

Typ: liczba całkowita
prop

Which pieces of information to get.

Note that if no values are selected, the result will contain the wikitext, but the output will be in a deprecated format.

wikitext
Rozwinięty wikitekst.
categories
Any categories present in the input that are not represented in the wikitext output.
properties
Page properties defined by expanded magic words in the wikitext.
volatile
Whether the output is volatile and should not be reused elsewhere within the page.
ttl
The maximum time after which caches of the result should be invalidated.
modules
Any ResourceLoader modules that parser functions have requested be added to the output. Either jsconfigvars or encodedjsconfigvars must be requested jointly with modules.
jsconfigvars
Gives the JavaScript configuration variables specific to the page.
encodedjsconfigvars
Gives the JavaScript configuration variables specific to the page as a JSON string.
parsetree
The XML parse tree of the input.
Wartości (oddziel za pomocą | lub alternatywy): categories, encodedjsconfigvars, jsconfigvars, modules, parsetree, properties, ttl, volatile, wikitext
includecomments

Whether to include HTML comments in the output.

Type: boolean (details)
showstrategykeys

Whether to include internal merge strategy information in jsconfigvars.

Type: boolean (details)
generatexml
Przestarzałe.

Generate XML parse tree (replaced by prop=parsetree).

Type: boolean (details)

action=feedcontributions

Zwraca kanał wkładu użytkownika.

Parametry:
feedformat

Format danych wyjściowych.

Jedna z następujących wartości: atom, rss
Domyślnie: rss
user

Jakich użytkowników pobrać wkład.

Ten parametr jest wymagany.
Typ: użytkownik, podany jako: nazwa użytkownika, IP, zakres IP, nazwa interwiki (np. „prefiks>PrzykładowaNazwa”) oraz ID użytkownika (np. „#12345”)
namespace

Z jakiej przestrzeni nazw wyświetlać wkład użytkownika.

Jedna z następujących wartości: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
year

Od roku (i wcześniej).

Typ: liczba całkowita
month

Od miesiąca (i wcześniej).

Typ: liczba całkowita
tagfilter

Pokaż tylko wkład z tymi znacznikami.

Wartości (oddziel za pomocą | lub alternatywy): mw-blank, mw-changed-redirect-target, mw-contentmodelchange, mw-manual-revert, mw-new-redirect, mw-removed-redirect, mw-replace, mw-reverted, mw-rollback, mw-server-side-upload, mw-undo
Domyślnie: (puste)
deletedonly

Pokazuj tylko usunięty wkład.

Type: boolean (details)
toponly

Pokazuj tylko edycje będące ostatnią zmianą strony.

Type: boolean (details)
newonly

Pokazuj tylko edycje tworzące stronę.

Type: boolean (details)
hideminor

Ukryj drobne zmiany.

Type: boolean (details)
showsizediff

Pokaż różnicę rozmiaru między wersjami.

Type: boolean (details)
Przykład:
Zwróć liste edycji dokonanych przez użytkownika Example.
api.php?action=feedcontributions&user=Example [otwórz w brudnopisie]

action=feedrecentchanges

Zwraca kanał ostatnich zmian.

Parametry:
feedformat

Format danych wyjściowych.

Jedna z następujących wartości: atom, rss
Domyślnie: rss
namespace

Przestrzeń nazw, do której ograniczone są wyniki.

Jedna z następujących wartości: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
invert

Wszystkie przestrzenie nazw oprócz wybranej.

Type: boolean (details)
associated

Uwzględnij powiązaną przestrzeń nazw (dyskusja lub treść).

Type: boolean (details)
days

Dni, do których ograniczone są wyniki.

Typ: liczba całkowita
Wartość nie może być mniejsza niż 1.
Domyślnie: 7
limit

Maksymalna liczba zwracanych wyników.

Typ: liczba całkowita
Wartość musi znajdować się pomiędzy 1 a 50.
Domyślnie: 50
from

Pokaż zmiany od tamtej chwili.

Typ: znacznik czasu (dozwolone formaty)
hideminor

Ukryj drobne zmiany.

Type: boolean (details)
hidebots

Ukryj zmiany zrobione przez boty.

Type: boolean (details)
hideanons

Ukryj zmiany zrobione przez anonimowych użytkowników.

Type: boolean (details)
hideliu

Ukryj zmiany zrobione przez zarejestrowanych użytkowników.

Type: boolean (details)
hidepatrolled

Ukryj sprawdzone zmiany.

Type: boolean (details)
hidemyself

Ukryj zmiany zrobione przez obecnego użytkownika.

Type: boolean (details)
hidecategorization

Ukryj zmiany w kategoryzacji.

Type: boolean (details)
tagfilter

Filtruj po znacznikach.

target

Pokaż tylko zmiany na stronach linkowanych z tej strony.

showlinkedto

Pokaż zmiany na stronach linkujących do wybranej strony.

Type: boolean (details)

action=feedwatchlist

Zwraca kanał listy obserwowanych.

Parametry:
feedformat

Format kanału.

Jedna z następujących wartości: atom, rss
Domyślnie: rss
hours

Wymień strony zmienione w ciągu tylu godzin licząc od teraz.

Typ: liczba całkowita
Wartość musi znajdować się pomiędzy 1 a 72.
Domyślnie: 24
linktosections

Linkuj bezpośrednio do zmienionych sekcji jeżeli to możliwe.

Type: boolean (details)
allrev

Include multiple revisions of the same page within given timeframe.

Type: boolean (details)
wlowner

Used along with token to access a different user's watchlist.

Typ: użytkownik, podany jako: nazwa użytkownika
wltoken

A security token (available in the user's preferences) to allow access to another user's watchlist.

wlshow

Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set show=minor|!anon.

Wartości (oddziel za pomocą | lub alternatywy): !anon, !autopatrolled, !bot, !minor, !patrolled, !unread, anon, autopatrolled, bot, minor, patrolled, unread
wltype

Which types of changes to show:

edit
Regular page edits.
new
Page creations.
log
Log entries.
external
Zmiany zewnętrzne.
categorize
Category membership changes.
Wartości (oddziel za pomocą | lub alternatywy): categorize, edit, external, log, new
Domyślnie: edit|new|log|categorize
wlexcludeuser

Nie wyświetlaj zmian wykonanych przez tego użytkownika.

Typ: użytkownik, podany jako: nazwa użytkownika, IP, nazwa interwiki (np. „prefiks>PrzykładowaNazwa”) oraz ID użytkownika (np. „#12345”)
Przykłady:
Pokaż kanał listy obserwowanych.
api.php?action=feedwatchlist [otwórz w brudnopisie]
Pokaż wszystkie zmiany na obserwowanych stronach dokonane w ciągu ostatnich 6 godzin.
api.php?action=feedwatchlist&allrev=&hours=6 [otwórz w brudnopisie]

action=filerevert

  • Ten moduł wymaga praw odczytu.
  • Ten moduł wymaga praw zapisu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: MediaWiki
  • Licencja: GPL-2.0-or-later

Przywróć plik do starej wersji.

Parametry:
filename

Docelowa nazwa pliku bez prefiksu Plik:

Ten parametr jest wymagany.
comment

Prześlij komentarz.

Domyślnie: (puste)
archivename

Archive name of the revision to revert to.

Ten parametr jest wymagany.
token

Token „csrf” pobrany z action=query&meta=tokens

Ten parametr jest wymagany.

action=help

(