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.

acquiretempusername
Acquire a temporary user username and stash it in the current session, if temp account creation is enabled and the current user is logged out. If a name has already been stashed, returns the same name.
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.
flickrblacklist
Validate a Flickr URL by using the user ID (NSID) for blacklisting.
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.
mediadetection
Return the likelihood that the stashed image represented by the supplied filekey is a logo
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.
templatedata
Pobierz dane zapisane przez rozszerzenie TemplateData.
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.
editcheckreferenceurl
Wewnętrzny. Check the status of a URL for use as a reference.
stashedit
Wewnętrzny. Prepare an edit in shared cache.
visualeditor
Wewnętrzny. Zwraca kod HTML5 strony za pośrednictwem usługi Parsoid.
visualeditoredit
Wewnętrzny. Zapisz stronę HTML5 w MediaWiki (konwertowana na wikikod przez usługę Parsoid).
Jedna z następujących wartości: acquiretempusername, block, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, flickrblacklist, help, imagerotate, import, linkaccount, login, logout, managetags, mediadetection, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, tag, templatedata, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, categorytree, cspreport, editcheckreferenceurl, stashedit, visualeditor, visualeditoredit
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
Wartość nie może być mniejsza niż 0.
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
Wartość nie może być mniejsza niż 0.
Domyślnie: 0
assert

Zweryfikuj, czy użytkownik jest zalogowany (włączając potencjalnych użytkowników tymczasowych), 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 oraz Tymczasowy użytkownik
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.

Typ: wartość boolowska (szczegóły)
curtimestamp

Dołącz obecny znacznik czasu do wyniku.

Typ: wartość boolowska (szczegóły)
responselanginfo

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

Typ: wartość boolowska (szczegóły)
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.

Typ: wartość boolowska (szczegóły)
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:
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=acquiretempusername

  • 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

Acquire a temporary user username and stash it in the current session, if temp account creation is enabled and the current user is logged out. If a name has already been stashed, returns the same name.

If the user later performs an action that results in temp account creation, the stashed username will be used for their account. It may also be used in previews. However, the account is not created yet, and the name is not visible to other users.

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:
Other general parameters are available.
user

Użytkownik, którego chcesz zablokować.

Typ: użytkownik, podany jako: nazwa użytkownika, IP, Tymczasowy użytkownik, 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).

Typ: wartość boolowska (szczegóły)
nocreate

Zapobiegnij utworzeniu konta.

Typ: wartość boolowska (szczegóły)
autoblock

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

Typ: wartość boolowska (szczegóły)
noemail

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

Typ: wartość boolowska (szczegóły)
hidename

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

Typ: wartość boolowska (szczegóły)
allowusertalk

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

Typ: wartość boolowska (szczegóły)
reblock

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

Typ: wartość boolowska (szczegóły)
watchuser

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

Typ: wartość boolowska (szczegóły)
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.

Typ: wartość boolowska (szczegóły)
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, 460, 461
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:
Other general parameters are available.
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:
Other general parameters are available.
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:
Other general parameters are available.
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: Campaign, css, javascript, json, text, wikitext
bot

Oznacz zmianę modelu zawartości flagą bota.

Typ: wartość boolowska (szczegóły)
token

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

Ten parametr jest wymagany.

action=checktoken

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

Parametry:
Other general parameters are available.
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:
Other general parameters are available.
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 mogących korzystać z podwyższonych limitów).
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.

Typ: wartość boolowska (szczegóły)
loginpreservestate

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

Typ: wartość boolowska (szczegóły)
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.

Typ: wartość boolowska (szczegóły)
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:
Other general parameters are available.
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: Campaign, css, javascript, json, text, unknown, wikitext
frompst

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

Typ: wartość boolowska (szczegóły)
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: Campaign, 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: Campaign, css, javascript, json, text, unknown, wikitext
topst

Do a pre-save transform on totext.

Typ: wartość boolowska (szczegóły)
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: Campaign, 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 username 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
The timestamp of the 'from' and 'to' revisions.
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 *.
difftype

Return the comparison formatted as inline HTML.

Jedna z następujących wartości: table, unified
Domyślnie: table
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:
Other general parameters are available.
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 mogących korzystać z podwyższonych limitów).
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.

Typ: wartość boolowska (szczegóły)
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.

Typ: wartość boolowska (szczegóły)
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.

Typ: wartość boolowska (szczegóły)
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:
Other general parameters are available.
reportonly

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

Typ: wartość boolowska (szczegóły)
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:
Other general parameters are available.
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.

Typ: wartość boolowska (szczegóły)
watch
Przestarzałe.

Dodaj stronę do obecnej listy obserwowanych.

Typ: wartość boolowska (szczegóły)
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.

Typ: wartość boolowska (szczegóły)
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:
Other general parameters are available.
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ę.

Typ: wartość boolowska (szczegóły)
notminor

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

Typ: wartość boolowska (szczegóły)
bot

Oznacz tę edycję jako edycję bota.

Typ: wartość boolowska (szczegóły)
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.

Typ: wartość boolowska (szczegóły)
createonly

Nie edytuj strony, jeśli już istnieje.

Typ: wartość boolowska (szczegóły)
nocreate

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

Typ: wartość boolowska (szczegóły)
watch
Przestarzałe.

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

Typ: wartość boolowska (szczegóły)
unwatch
Przestarzałe.

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

Typ: wartość boolowska (szczegóły)
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 lub sekcji. Zastępuje text.

appendtext

Tekst do dodania na końcu strony lub sekcji. 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.

Typ: wartość boolowska (szczegóły)
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: Campaign, 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.
returnto

Page title. If saving the edit created a temporary account, the API may respond with an URL that the client should visit to complete logging in. If this parameter is provided, the URL will redirect to the given page, instead of the page that was edited.

Typ: nazwa strony
Akceptuje nieistniejące strony.
returntoquery

URL query parameters (with leading ?). If saving the edit created a temporary account, the API may respond with an URL that the client should visit to complete logging in. If this parameter is provided, the URL will redirect to a page with the given query parameters.

Domyślnie: (puste)
returntoanchor

URL fragment (with leading #). If saving the edit created a temporary account, the API may respond with an URL that the client should visit to complete logging in. If this parameter is provided, the URL will redirect to a page with the given fragment.

Domyślnie: (puste)

action=editcheckreferenceurl

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

Check the status of a URL for use as a reference.

Parametr:
Other general parameters are available.
url

URL to check.

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:
Other general parameters are available.
target

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

Ten parametr jest wymagany.
subject

Nagłówek tematu.

Ten parametr jest wymagany.
text

Treść emaila.

Ten parametr jest wymagany.
ccme

Wyślij kopię wiadomości do mnie.

Typ: wartość boolowska (szczegóły)
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:
Other general parameters are available.
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.

Typ: wartość boolowska (szczegóły)
showstrategykeys

Whether to include internal merge strategy information in jsconfigvars.

Typ: wartość boolowska (szczegóły)
generatexml
Przestarzałe.

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

Typ: wartość boolowska (szczegóły)

action=feedcontributions

Zwraca kanał wkładu użytkownika.

Parametry:
Other general parameters are available.
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, Tymczasowy użytkownik, 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, 460, 461
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): editcheck-newcontent, editcheck-newreference, editcheck-reference-decline-common-knowledge, editcheck-reference-decline-irrelevant, editcheck-reference-decline-other, editcheck-reference-decline-uncertain, editcheck-references, editcheck-references-activated, 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, uploadwizard, uploadwizard-flickr, visualeditor, visualeditor-needcheck, visualeditor-switched, visualeditor-wikitext, wikieditor
Domyślnie: (puste)
deletedonly

Pokazuj tylko usunięty wkład.

Typ: wartość boolowska (szczegóły)
toponly

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

Typ: wartość boolowska (szczegóły)
newonly

Pokazuj tylko edycje tworzące stronę.

Typ: wartość boolowska (szczegóły)
hideminor

Ukryj drobne zmiany.

Typ: wartość boolowska (szczegóły)
showsizediff

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

Typ: wartość boolowska (szczegóły)
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:
Other general parameters are available.