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.

abusefiltercheckmatch
Sprawdź, by przekonać się, czy filtr nadużyć dopasowuje się do zestawu zmiennych, edycji lub zarejestrowanego zdarzenia filtra nadużyć.
abusefilterchecksyntax
Sprawdź składnię filtra nadużyć.
abusefilterevalexpression
Ewaluuje wyrażenie filtra nadużyć.
abusefilterunblockautopromote
Zdejmuje z użytkownika blokadę autopromocji, która została nałożona przez filtr nadużyć.
abuselogprivatedetails
Wyświetl prywatne szczegóły wpisu w rejestrze nadużyć.
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
chatgetnew
Get new messages in the chat.
chatkick
Kick a user from the chat
chatsend
Send a public message to the chat
chatsendpm
Wyślij prywatną wiadomość użytkownikowi
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.
csdeletecomment
Delete a comment. Either pageid or title must be provided.
csdeletereply
Delete a reply. Either pageid or title must be provided.
cseditcomment
Edit an existing comment. Either pageid or title must be provided.
cseditreply
Edit an existing reply. Either pageid or title must be provided.
cspostcomment
Post a new comment.
cspostreply
Post a new reply.
csquerycomment
Return details of a comment. Either pageid or title must be provided.
csqueryreply
Return details of a reply. Either pageid or title must be provided.
csunwatch
Unwatch a comment to no longer be notified when it receives replies
csvote
Vote (up, down, or neutral) on a comment.
cswatch
Watch a comment to be notified when it receives replies
delete
Usuń stronę.
discussiontoolsedit
Wyślij wiadomość na stronie dyskusji.
discussiontoolsfindcomment
Znajdź komentarz o danym identyfikatorze lub nazwie.
discussiontoolsgetsubscriptions
Sprawdź status subskrypcji podanych tematów.
discussiontoolssubscribe
Subskrybuj (lub anuluj subskrypcję), aby otrzymywać powiadomienia o komentarzach w danym temacie.
echomarkread
Oznacz powiadomienia jako przeczytane dla bieżącego użytkownika.
echomarkseen
Oznacz powiadomienia jako przeczytane dla bieżącego użytkownika.
echomute
Mute or unmute notifications from certain users or pages.
edit
Twórz i edytuj strony.
emailuser
Wyślij e‐mail do użytkownika.
expandtemplates
Rozwija wszystkie szablony zawarte w wikitekście.
favorite
Add or remove a page from/to the current user's favorite list
feedcontributions
Zwraca kanał wkładu użytkownika.
feedrecentchanges
Zwraca kanał ostatnich zmian.
feedwatchlist
Zwraca kanał listy obserwowanych.
filerevert
Przywróć plik do starej wersji.
getheaderfooter
Retrieve the parsed output of a header or footer in the context of a certain page.
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.
inlinecomments-add
Dodaj nowy komentarz.
inlinecomments-addreply
Add a reply to an inline comment
inlinecomments-resolve
Mark an inline comment resolved and remove from page
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.
moderation
Performs moderation-related action like Approve or Reject.
move
Przenieś stronę.
opensearch
Przeszukaj wiki przy użyciu protokołu OpenSearch.
options
Zmienia preferencje bieżącego użytkownika.
pageownership-check-latest-version
check extension's latest version
pageownership-get-permissions
pageownership get permissions
pageownership-set-permissions
pageownership set permissions
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.
shortenurl
Skróć długi adres URL do krótszej postaci.
subpagenavigation-check-latest-version
subpagenavigation check latest version
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.
webapp-manifest
Zwraca manifest webapp.
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.
discussiontoolscompare
Wewnętrzny. Uzyskaj informacje o zmianach komentarzy pomiędzy dwiema wersjami strony.
discussiontoolspageinfo
Wewnętrzny. Zwraca metadane niezbędne do zainicjowania narzędzi dyskusji.
discussiontoolspreview
Wewnętrzny. Zobacz podgląd wiadomości na stronie dyskusji.
oathvalidate
Wewnętrzny. Waliduj token uwierzytelniania dwuskładnikowego (OATH).
stashedit
Wewnętrzny. Prepare an edit in shared cache.
subpagenavigation-tree
Wewnętrzny. subpagenavigation tree summary
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: abusefiltercheckmatch, abusefilterchecksyntax, abusefilterevalexpression, abusefilterunblockautopromote, abuselogprivatedetails, acquiretempusername, block, changeauthenticationdata, changecontentmodel, chatgetnew, chatkick, chatsend, chatsendpm, checktoken, clearhasmsg, clientlogin, compare, createaccount, csdeletecomment, csdeletereply, cseditcomment, cseditreply, cspostcomment, cspostreply, csquerycomment, csqueryreply, csunwatch, csvote, cswatch, delete, discussiontoolsedit, discussiontoolsfindcomment, discussiontoolsgetsubscriptions, discussiontoolssubscribe, echomarkread, echomarkseen, echomute, edit, emailuser, expandtemplates, favorite, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, getheaderfooter, help, imagerotate, import, inlinecomments-add, inlinecomments-addreply, inlinecomments-resolve, linkaccount, login, logout, managetags, mergehistory, moderation, move, opensearch, options, pageownership-check-latest-version, pageownership-get-permissions, pageownership-set-permissions, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, shortenurl, subpagenavigation-check-latest-version, tag, templatedata, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, webapp-manifest, cspreport, discussiontoolscompare, discussiontoolspageinfo, discussiontoolspreview, oathvalidate, stashedit, subpagenavigation-tree, 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, 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.

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:
writeapi
Zapis poprzez interfejs API
Przydzielone dla: all, user, bot, hindusi, odkrywajacy, swiadomikursanci, widziksiazki oraz gitkursanci
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=abusefiltercheckmatch

  • Ten moduł wymaga praw odczytu.
  • Źródło: Abuse Filter
  • Licencja: GPL-2.0-or-later

Sprawdź, by przekonać się, czy filtr nadużyć dopasowuje się do zestawu zmiennych, edycji lub zarejestrowanego zdarzenia filtra nadużyć.

vars, rcid albo logid jest wymagane, ale tylko jedno może zostać użyte.

Parametry:
Other general parameters are available.
filter

Pełny tekst filtru do sprawdzenia zgodności.

Ten parametr jest wymagany.
vars

Tablica zmiennych do testowania zakodowana w formacie JSON.

rcid

ID jednej z ostatnich zmian, którą należy sprawdzić.

Typ: liczba całkowita
logid

ID wpisu w rejestrze nadużyć do sprawdzenia.

Typ: liczba całkowita
Przykład:
Sprawdź, czy identyfikator ostatnich zmian 15 dopasowuje się do prostego filtra
api.php?action=abusefiltercheckmatch&filter=!("autoconfirmed"%20in%20user_groups)&rcid=15 [otwórz w brudnopisie]

action=abusefilterchecksyntax

  • Ten moduł wymaga praw odczytu.
  • Źródło: Abuse Filter
  • Licencja: GPL-2.0-or-later

Sprawdź składnię filtra nadużyć.

Parametr:
Other general parameters are available.
filter

Pełny tekst filtru do sprawdzenia zgodności składni.

Ten parametr jest wymagany.

action=abusefilterevalexpression

  • Ten moduł wymaga praw odczytu.
  • Źródło: Abuse Filter
  • Licencja: GPL-2.0-or-later

Ewaluuje wyrażenie filtra nadużyć.

Parametry:
Other general parameters are available.
expression

Wyrażenie do sprawdzenia.

Ten parametr jest wymagany.
prettyprint

Czy wynik powinien zostać sformatowany.

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

action=abusefilterunblockautopromote

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

Zdejmuje z użytkownika blokadę autopromocji, która została nałożona przez filtr nadużyć.

Parametry:
Other general parameters are available.
user

Nazwa użytkownika, którego chcesz odblokować.

Ten parametr jest wymagany.
Typ: użytkownik, podany jako: nazwa użytkownika
token

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

Ten parametr jest wymagany.

action=abuselogprivatedetails

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

Wyświetl prywatne szczegóły wpisu w rejestrze nadużyć.

Parametry:
Other general parameters are available.
logid

Identyfikator wpisu w rejestrze nadużyć do sprawdzenia.

Typ: liczba całkowita
reason

Poprawny powód, dla którego wykonujesz sprawdzenie.

token

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

Ten parametr jest wymagany.
Przykład:
Pozyskaj prywatne szczegóły wpisu rejestru nadużyć o ID 1, podając powód „przykład”.
api.php?action=abuselogprivatedetails&logid=1&reason=example&token=ABC123 [otwórz w brudnopisie]

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, 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, 274, 275, 844, 845, 2300, 2301, 2302, 2303, 2940, 2941, 3000, 3001, 3010, 3011, 3020, 3021, 3030, 3031, 3040, 3041
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=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: GadgetDefinition, StructuredNavigation, annotation+json, css, javascript, json, sanitized-css, 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=chatgetnew

  • Ten moduł wymaga praw odczytu.
  • Źródło: MediaWikiChat
  • Licencja: GPL-2.0-or-later

Get new messages in the chat.

Parametr:
Other general parameters are available.
focussed

is the chat tab open/focused right now?

Typ: wartość boolowska (szczegóły)
Przykład:
Get new messages in the chat
api.php?action=chatgetnew [otwórz w brudnopisie]

action=chatkick

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

Kick a user from the chat

Parametr:
Other general parameters are available.
id

The user ID to kick

Ten parametr jest wymagany.
Typ: liczba całkowita
Przykład:
Kick the user with ID of 1
api.php?action=chatkick&id=1 [otwórz w brudnopisie]

action=chatsend

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

Send a public message to the chat

Parametr:
Other general parameters are available.
message

Wiadomość do wysłania

Ten parametr jest wymagany.

action=chatsendpm

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

Wyślij prywatną wiadomość użytkownikowi

Parametry:
Other general parameters are available.
message

The message to send

Ten parametr jest wymagany.
id

The user ID to send a PM to

Ten parametr jest wymagany.
Typ: liczba całkowita

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 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.

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): inlinecomments, 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: GadgetDefinition, StructuredNavigation, annotation+json, css, javascript, json, sanitized-css, 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: GadgetDefinition, StructuredNavigation, annotation+json, css, javascript, json, sanitized-css, 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): inlinecomments, 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: GadgetDefinition, StructuredNavigation, annotation+json, css, javascript, json, sanitized-css, 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: GadgetDefinition, StructuredNavigation, annotation+json, css, javascript, json, sanitized-css, 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): inlinecomments, 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 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.

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=csdeletecomment

  • Ten moduł wymaga praw odczytu.
  • Ten moduł akceptuje tylko żądania POST.
  • Źródło: CommentStreams
  • Licencja: MIT

Delete a comment. Either pageid or title must be provided.

Parametry:
Other general parameters are available.
pageid

page ID of the page which holds the comment to delete

Typ: liczba całkowita
title

title of the page which holds the comment to delete

token

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

Ten parametr jest wymagany.