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
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
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.
Testowanie: Aby łatwo testować żądania API, zobacz Special:ApiSandbox.
- 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ę
hasmsgdla 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-maxagena 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ą
maxagena 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łówkowiOrigin, zwrócona zostanie odpowiedź z błędem 403. Jeżeli parametr odpowiada nagłówkowiOrigin, a domena źródłowa należy do akceptowanych, ustawione zostaną nagłówkiAccess-Control-Allow-OriginorazAccess-Control-Allow-Credentials.W nieuwierzytelnionych żądaniach podaj wartość *. Sprawi to, że ustawiony zostanie nagłówek
Access-Control-Allow-Origin, jednak nagłówekAccess-Control-Allow-Credentialsotrzyma wartośćfalsea 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)
- 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]
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.
- 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)
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.
- 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.
- 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.
- 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ą.
- Spróbuj zmienić hasło bieżącego użytkownika na ExamplePassword.
- api.php?action=changeauthenticationdata&changeauthrequest=MediaWiki%5CAuth%5CPasswordAuthenticationRequest&password=ExamplePassword&retype=ExamplePassword&changeauthtoken=123ABC [otwórz w brudnopisie]
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
- 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
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.
- Zmień stronę główną na model zawartości
text - api.php?action=changecontentmodel&title=Main Page&model=text&token=123ABC [otwórz w brudnopisie]
action=checktoken
- Ten moduł wymaga praw odczytu.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
Sprawdź poprawność tokenu z action=query&meta=tokens.
- 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
- Sprawdź poprawność tokenu csrf.
- api.php?action=checktoken&type=csrf&token=123ABC [otwórz w brudnopisie]
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.
- Wyczyść flagę
hasmsgdla 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:
- Fetch the fields available from action=query&meta=authmanagerinfo with amirequestsfor=login, and a login token from action=query&meta=tokens.
- Present the fields to the user, and obtain their submission.
- Post to this module, supplying loginreturnurl and any relevant fields.
- 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.
- 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ą.
- 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
- Ten moduł wymaga praw odczytu.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
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.
- 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
- 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:
- Fetch the fields available from action=query&meta=authmanagerinfo with amirequestsfor=create, and a createaccount token from action=query&meta=tokens.
- Present the fields to the user, and obtain their submission.
- Post to this module, supplying createreturnurl and any relevant fields.
- 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.
- 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ą.
- Start the process of creating the user Example with the password ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [otwórz w brudnopisie]
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.
- 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ę.
- 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.
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.
- Usuń Main Page.
- api.php?action=delete&title=Strona%20g%C5%82%C3%B3wna%20foto&token=123ABC [otwórz w brudnopisie]
- Usuń Main Page z powodem Preparing for move.
- api.php?action=delete&title=Strona%20g%C5%82%C3%B3wna%20foto&token=123ABC&reason=Preparing%20for%20move [otwórz w brudnopisie]
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.
- 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.
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)
- Edytuj stronę.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [otwórz w brudnopisie]
- Dopisz __NOTOC__ na początku strony.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [otwórz w brudnopisie]
- Undo revisions 13579 through 13585 with autosummary.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [otwórz w brudnopisie]
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.
- 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.
- 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.
- 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
- Ten moduł wymaga praw odczytu.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
Rozwija wszystkie szablony zawarte w wikitekście.
- 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)
- Expand the wikitext {{Project:Sandbox}}.
- api.php?action=expandtemplates&text={{Project:Sandbox}} [otwórz w brudnopisie]
action=feedcontributions
- Ten moduł wymaga praw odczytu.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
Zwraca kanał wkładu użytkownika.
- 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)
- Zwróć liste edycji dokonanych przez użytkownika Example.
- api.php?action=feedcontributions&user=Example [otwórz w brudnopisie]
action=feedrecentchanges
- Ten moduł wymaga praw odczytu.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
Zwraca kanał ostatnich zmian.