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.
- 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.
- help
- Wyświetl pomoc dla określonych modułów.
- imagerotate
- Obróć jeden lub wiecej obrazków.
- import
- Zaimportuj stronę z innej wiki, lub sformułuj plik XML.
- linkaccount
- Link an account from a third-party provider to the current user.
- login
- Zaloguj się i pobierz ciasteczka poświadczeń.
- logout
- Wyloguj i wyczyść dane sesji.
- managetags
- Wykonywanie zadań związanych z zarządzaniem znacznikami zmian.
- mergehistory
- Łączenie historii edycji.
- move
- Przenieś stronę.
- opensearch
- Przeszukaj wiki przy użyciu protokołu OpenSearch.
- options
- Zmienia preferencje bieżącego użytkownika.
- paraminfo
- Zdobądź informacje o modułach API.
- parse
- Parsuje treść i zwraca wynik pracy parsera.
- patrol
- Sprawdź stronę lub edycję.
- protect
- Zmień poziom zabezpieczenia strony.
- purge
- Wyczyść pamięć podręczną dla stron o podanych tytułach.
- query
- Pozyskuj dane z i o MediaWiki.
- removeauthenticationdata
- Usuń dane poświadczeń obecnego użytkownika.
- resetpassword
- Wyślij użytkownikowi e-mail do resetowania hasła.
- revisiondelete
- Usuwaj i przywracaj wersje.
- rollback
- Wycofaj ostatnią edycję na stronie.
- rsd
- Export an RSD (Really Simple Discovery) schema.
- setnotificationtimestamp
- Update the notification timestamp for watched pages.
- setpagelanguage
- Zmień język strony.
- tag
- Add or remove change tags from individual revisions or log entries.
- unblock
- Odblokuj użytkownika.
- undelete
- Odtwórz wersje usuniętej strony.
- unlinkaccount
- Remove a linked third-party account from the current user.
- upload
- Upload a file, or get the status of pending uploads.
- userrights
- Zmień przynależność użytkownika do grup.
- validatepassword
- Validate a password against the wiki's password policies.
- watch
- Dodaj strony do listy obserwowanych obecnego użytkownika lub usuń je z niej.
- categorytree
- Wewnętrzny. Wewnętrzny moduł rozszerzenia CategoryTree.
- cspreport
- Wewnętrzny. Used by browsers to report violations of the Content Security Policy. This module should never be used, except when used automatically by a CSP compliant web browser.
- stashedit
- Wewnętrzny. Prepare an edit in shared cache.
- Jedna z następujących wartości: block, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, help, imagerotate, import, linkaccount, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, tag, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, categorytree, cspreport, stashedit
- Domyślnie: help
- format
Format danych wyjściowych.
- json
- Dane wyjściowe w formacie JSON.
- jsonfm
- Dane wyjściowe w formacie JSON (prawidłowo wyświetlane w HTML).
- none
- Output nothing.
- php
- Dane wyjściowe w serializowany formacie PHP.
- phpfm
- Dane wyjściowe w serializowanym formacie PHP (prawidłowo wyświetlane w HTML).
- rawfm
- Output data, including debugging elements, in JSON format (pretty-print in HTML).
- xml
- Dane wyjściowe w formacie XML.
- xmlfm
- Dane wyjściowe w formacie XML (prawidłowo wyświetlane w HTML).
- Jedna z następujących wartości: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
- Domyślnie: jsonfm
- maxlag
Maksymalne opóźnienie mogą być używane kiedy MediaWiki jest zainstalowana w klastrze zreplikowanej bazy danych. By zapisać działania powodujące większe opóźnienie replikacji, ten parametr może wymusić czekanie u klienta, dopóki opóźnienie replikacji jest mniejsze niż określona wartość. W przypadku nadmiernego opóźnienia, kod błędu maxlag jest zwracany z wiadomością jak Oczekiwanie na $host: $lag sekund opóźnienia.
Zobacz Podręcznik:Parametr Maxlag by uzyskać więcej informacji.- Typ: liczba całkowita
- smaxage
Ustaw nagłówek HTTP kontrolujący pamięć podręczną
s-maxagena taką ilość sekund. Błędy nie będą nigdy przechowywane w pamięci podręcznej.- Typ: liczba całkowita
- Domyślnie: 0
- maxage
Ustaw nagłówek HTTP kontrolujący pamięć podręczną
maxagena taką ilość sekund. Błędy nie będą nigdy przechowywane w pamięci podręcznej.- Typ: liczba całkowita
- Domyślnie: 0
- assert
Zweryfikuj, czy użytkownik jest zalogowany, jeżeli wybrano user, niezalogowany, jeżeli wybrano anon, lub czy ma uprawnienia bota, jeżeli wybrano bot.
- Jedna z następujących wartości: anon, bot, user
- assertuser
Sprawdź, czy bieżący użytkownik posiada nazwę.
- Typ: użytkownik, podany jako: nazwa użytkownika
- requestid
Każda wartość tu podana będzie dołączana do odpowiedzi. Może być użyta do rozróżniania żądań.
- servedby
Dołącz do odpowiedzi nazwę hosta, który obsłużył żądanie.
- Type: boolean (details)
- curtimestamp
Dołącz obecny znacznik czasu do wyniku.
- Type: boolean (details)
- responselanginfo
Dołącz języki użyte w uselang i errorlang do wyniku.
- Type: boolean (details)
- origin
Łącząc się z API używając żądań AJAX z innej domeny internetowej (CORS) ustaw wartość tego parametru na domenę źródłową. Parametr ten musi być uwzględniony w każdym podstawowym żądaniu, toteż musi być częścią URI żądania (nie częścią żądania POST).
W uwierzytelnionych żądaniach wartość tego parametru musi dokładnie odpowiadać jednej ze źródłowych domen w nagłówku
Origin, powinna więc pasować do wzoru https://en.wikipedia.org lub https://meta.wikimedia.org. Jeżeli parametr nie odpowiada nagłó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.
- Type: boolean (details)
- 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=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, zakres IP oraz ID użytkownika (np. „#12345”)
- userid
- Przestarzałe.
Zamiast tego podaj parametr user=#ID.
- Typ: liczba całkowita
- expiry
Czas trwania. Może być względny (np. 5 months or 2 weeks) lub konkretny (np. 2014-09-18T12:34:56Z). Jeśli jest ustawiony na infinite, indefinite, lub never, blokada nigdy nie wygaśnie.
- Domyślnie: never
- reason
Powód blokady.
- Domyślnie: (puste)
- anononly
Blokuj tylko anonimowych użytkowników (blokuje anonimowe edycje z tego adresu IP).
- Type: boolean (details)
- nocreate
Zapobiegnij utworzeniu konta.
- Type: boolean (details)
- autoblock
Zablokuj ostatni adres IP tego użytkownika i automatycznie wszystkie kolejne, z których będzie się logował.
- Type: boolean (details)
- noemail
Uniemożliwia użytkownikowi wysyłanie wiadomości e-mail za pośrednictwem interfejsu wiki. (Wymagane uprawnienie
blockemail).- Type: boolean (details)
- hidename
Ukryj nazwę użytkownika z rejestru blokad. (Wymagane uprawnienie
hideuser)- Type: boolean (details)
- allowusertalk
Pozwala użytkownikowi edytować własną stronę dyskusji (zależy od $wgBlockAllowsUTEdit).
- Type: boolean (details)
- reblock
Jeżeli ten użytkownik jest już zablokowany, nadpisz blokadę.
- Type: boolean (details)
- watchuser
Obserwuj stronę użytkownika lub IP oraz ich strony dyskusji.
- Type: boolean (details)
- tags
Znaczniki do dodania przy wpisie w rejestrze.
- Wartości (oddziel za pomocą | lub alternatywy):
- partial
Zablokuj użytkownikowi dostęp do wybranych stron lub przestrzeni nazw zamiast do całej witryny.
- Type: boolean (details)
- pagerestrictions
Lista tytułów stron do zablokowania użytkownikowi możliwości edycji. Ma zastosowanie tylko gdy partial (częściowa) jest ustawione na true (prawda).
- Typ: nazwa strony
- Oddziel wartości za pomocą | lub alternatywy.
- Maksymalna liczba wartości to 10.
- Akceptowane są tylko istniejące strony.
- namespacerestrictions
Lista ID przestrzeni nazw do zablokowania użytkownikowi możliwości edycji. Ma zastosowanie tylko gdy partial (częściowa) jest ustawione na true (prawda).
- Wartości (oddziel za pomocą | lub alternatywy): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- Aby wskazać wszystkie wartości, użyj *.
- token
Token „csrf” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- 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
- tags
Change tags to apply to the log entry and edit.
- Wartości (oddziel za pomocą | lub alternatywy):
- model
Model zawartości nowego tekstu.
- Ten parametr jest wymagany.
- Jedna z następujących wartości: css, javascript, json, text, wikitext
- bot
Oznacz zmianę modelu zawartości flagą bota.
- Type: boolean (details)
- token
Token „csrf” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- 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 z podwyższonymi limitami).
- loginmessageformat
Format to use for returning messages.
- Jedna z następujących wartości: html, none, raw, wikitext
- Domyślnie: wikitext
- loginmergerequestfields
Merge field information for all authentication requests into one array.
- Type: boolean (details)
- loginpreservestate
Preserve state from a previous failed login attempt, if possible.
- Type: boolean (details)
- loginreturnurl
Return URL for third-party authentication flows, must be absolute. Either this or logincontinue is required.
Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a logincontinue request to this API module.
- logincontinue
This request is a continuation after an earlier UI or REDIRECT response. Either this or loginreturnurl is required.
- Type: boolean (details)
- logintoken
Token „login” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- *
- Ten moduł akceptuje dodatkowe parametry, w zależności od dostępnych żądań poświadczeń. Użyj action=query&meta=authmanagerinfo z amirequestsfor=login (lub poprzednią odpowiedzią tego modułu, jeśli dotyczy) aby określić dostępne żądania i pola, których używają.
- 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: css, javascript, json, text, unknown, wikitext
- frompst
Dokonaj zapisu wersji roboczej transformacji przeprowadzonej na fromtext-{slot}.
- Type: boolean (details)
- fromtext
- Przestarzałe.
Specify fromslots=main and use fromtext-main instead.
- fromcontentformat
- Przestarzałe.
Specify fromslots=main and use fromcontentformat-main instead.
- Jedna z następujących wartości: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- fromcontentmodel
- Przestarzałe.
Specify fromslots=main and use fromcontentmodel-main instead.
- Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
- fromsection
- Przestarzałe.
Only use the specified section of the specified 'from' content.
- totitle
Drugi tytuł do porównania.
- toid
Numer drugiej strony do porównania.
- Typ: liczba całkowita
- torev
Druga wersja do porównania.
- Typ: liczba całkowita
- torelative
Use a revision relative to the revision determined from fromtitle, fromid or fromrev. All of the other 'to' options will be ignored.
- Jedna z następujących wartości: cur, next, prev
- toslots
Override content of the revision specified by totitle, toid or torev.
This parameter specifies the slots that are to be modified. Use totext-{slot}, tocontentmodel-{slot}, and tocontentformat-{slot} to specify content for each slot.
- Wartości (oddziel za pomocą | lub alternatywy): main
- totext-{slot}
Text of the specified slot. If omitted, the slot is removed from the revision.
- This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
- tosection-{slot}
When totext-{slot} is the content of a single section, this is the section identifier. It will be merged into the revision specified by totitle, toid or torev as if for a section edit.
- This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
- tocontentformat-{slot}
Content serialization format of totext-{slot}.
- This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
- Jedna z następujących wartości: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- tocontentmodel-{slot}
Content model of totext-{slot}. If not supplied, it will be guessed based on the other parameters.
- This is a templated parameter. When making the request, {slot} in the parameter's name should be replaced with values of toslots.
- Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
- topst
Do a pre-save transform on totext.
- Type: boolean (details)
- totext
- Przestarzałe.
Specify toslots=main and use totext-main instead.
- tocontentformat
- Przestarzałe.
Specify toslots=main and use tocontentformat-main instead.
- Jedna z następujących wartości: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- tocontentmodel
- Przestarzałe.
Specify toslots=main and use tocontentmodel-main instead.
- Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
- tosection
- Przestarzałe.
Only use the specified section of the specified 'to' content.
- prop
Which pieces of information to get.
- diff
- The diff HTML.
- diffsize
- The size of the diff HTML, in bytes.
- rel
- The revision IDs of the revision previous to 'from' and after 'to', if any.
- ids
- The page and revision IDs of the 'from' and 'to' revisions.
- title
- The page titles of the 'from' and 'to' revisions.
- user
- The user name and ID of the 'from' and 'to' revisions. If the user has been revision deleted, a fromuserhidden or touserhidden property will be returned.
- comment
- The comment on the 'from' and 'to' revisions. If the comment has been revision deleted, a fromcommenthidden or tocommenthidden property will be returned.
- parsedcomment
- The parsed comment on the 'from' and 'to' revisions. If the comment has been revision deleted, a fromcommenthidden or tocommenthidden property will be returned.
- size
- The size of the 'from' and 'to' revisions.
- timestamp
- (bez opisu)
- Wartości (oddziel za pomocą | lub alternatywy): comment, diff, diffsize, ids, parsedcomment, rel, size, timestamp, title, user
- Domyślnie: diff|ids|title
- slots
Return individual diffs for these slots, rather than one combined diff for all slots.
- Wartości (oddziel za pomocą | lub alternatywy): main
- Aby wskazać wszystkie wartości, użyj *.
- 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 z podwyższonymi limitami).
- createmessageformat
Format to use for returning messages.
- Jedna z następujących wartości: html, none, raw, wikitext
- Domyślnie: wikitext
- createmergerequestfields
Merge field information for all authentication requests into one array.
- Type: boolean (details)
- createpreservestate
Preserve state from a previous failed login attempt, if possible.
If action=query&meta=authmanagerinfo returned true for hasprimarypreservedstate, requests marked as primary-required should be omitted. If it returned a non-empty value for preservedusername, that username must be used for the username parameter.
- Type: boolean (details)
- createreturnurl
Return URL for third-party authentication flows, must be absolute. Either this or createcontinue is required.
Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a createcontinue request to this API module.
- createcontinue
This request is a continuation after an earlier UI or REDIRECT response. Either this or createreturnurl is required.
- Type: boolean (details)
- createtoken
Token „createaccount” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- *
- Ten moduł akceptuje dodatkowe parametry, w zależności od dostępnych żądań poświadczeń. Użyj action=query&meta=authmanagerinfo z amirequestsfor=create (lub poprzednią odpowiedzią tego modułu, jeśli dotyczy) aby określić dostępne żądania i pola, których używają.
- 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
- Type: boolean (details)
- source
What generated the CSP header that triggered this report
- Domyślnie: internal
action=delete
- Ten moduł wymaga praw odczytu.
- Ten moduł wymaga praw zapisu.
- Ten moduł akceptuje tylko żądania POST.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
Usuń stronę.
- title
Tytuł strony do usunięcia. Nie używać wraz z pageid.
- pageid
ID strony do usunięcia. Nie może być użyte wraz z title.
- Typ: liczba całkowita
- reason
Powód usuwania. Jeśli pozostawisz to pole puste, zostanie użyty powód wygenerowany automatycznie.
- tags
Change tags to apply to the entry in the deletion log.
- Wartości (oddziel za pomocą | lub alternatywy):
- deletetalk
Delete the talk page, if it exists.
- Type: boolean (details)
- watch
- Przestarzałe.
Dodaj stronę do obecnej listy obserwowanych.
- Type: boolean (details)
- watchlist
Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.
- Jedna z następujących wartości: nochange, preferences, unwatch, watch
- Domyślnie: preferences
- unwatch
- Przestarzałe.
Usuń stronę z obecnej listy obserwowanych.
- Type: boolean (details)
- oldimage
The name of the old image to delete as provided by action=query&prop=imageinfo&iiprop=archivename.
- token
Token „csrf” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- Usuń Main Page.
- api.php?action=delete&title=Main%20Page&token=123ABC [otwórz w brudnopisie]
- Usuń Main Page z powodem Preparing for move.
- api.php?action=delete&title=Main%20Page&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.
- tags
Znaczniki zmian do zastosowania w tej edycji.
- Wartości (oddziel za pomocą | lub alternatywy):
- minor
Oznacz tę zmianę jako drobną zmianę.
- Type: boolean (details)
- notminor
Nie oznaczaj tej zmiany jako drobną nawet jeśli ustawiona jest preferencja „Wszystkie edycje domyślnie oznaczaj jako drobne”.
- Type: boolean (details)
- bot
Oznacz tę edycję jako edycję bota.
- Type: boolean (details)
- baserevid
ID of the base revision, used to detect edit conflicts. May be obtained through action=query&prop=revisions. Self-conflicts cause the edit to fail unless basetimestamp is set.
- Typ: liczba całkowita
- basetimestamp
Czas wersji, która jest edytowana. Służy do wykrywania konfliktów edycji. Można pobrać poprzez action=query&prop=revisions&rvprop=timestamp. Konflikty z samym sobą są ignorowane.
- Typ: znacznik czasu (dozwolone formaty)
- starttimestamp
Czas rozpoczęcia procesu edycji. Służy do wykrywania konfliktów edycji. Odpowiednia wartość może być pobrana za pomocą curtimestamp podczas rozpoczynania procesu edycji (np. podczas ładowania zawartości strony do edycji).
- Typ: znacznik czasu (dozwolone formaty)
- recreate
Ignoruj błędy o usunięciu strony w międzyczasie.
- Type: boolean (details)
- createonly
Nie edytuj strony, jeśli już istnieje.
- Type: boolean (details)
- nocreate
Zwróć błąd, jeśli strona nie istnieje.
- Type: boolean (details)
- watch
- Przestarzałe.
Dodaj stronę do listy obserwowanych bieżącego użytkownika.
- Type: boolean (details)
- unwatch
- Przestarzałe.
Usuń stronę z listy obserwowanych bieżącego użytkownika.
- Type: boolean (details)
- watchlist
Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.
- Jedna z następujących wartości: nochange, preferences, unwatch, watch
- Domyślnie: preferences
- md5
Hash MD5 parametru text lub złączonych parametrów prependtext i appendtext. Jeżeli ustawiony, edycja nie zostanie zapisana dopóki hash nie będzie się zgadzać.
- prependtext
Tekst do dodania na początku strony. Zastępuje text.
- appendtext
Tekst do dodania na końcu strony. Zastępuje text.
Użyj section=new zamiast tego parametru aby dodać nową sekcję.
- undo
Wycofaj tę wersję. Zastępuje text, prependtext i appendtext.
- Typ: liczba całkowita
- Wartość nie może być mniejsza niż 0.
- undoafter
Wycofaj wszystkie wersje od undo do tej. Jeżeli nie ustawiono, wycofaj tylko jedną wersję.
- Typ: liczba całkowita
- Wartość nie może być mniejsza niż 0.
- redirect
Automatycznie rozwiązuj przekierowania.
- Type: boolean (details)
- contentformat
Format serializacji zawartości wprowadzonego tekstu.
- Jedna z następujących wartości: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- contentmodel
Model zawartości nowego tekstu.
- Jedna z następujących wartości: css, javascript, json, text, unknown, wikitext
- token
Token „csrf” pobrany z action=query&meta=tokens
Token powinien być wysyłany jako ostatni parametr albo przynajmniej po parametrze text.
- Ten parametr jest wymagany.
- 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=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.
- text
Treść emaila.
- Ten parametr jest wymagany.
- ccme
Wyślij kopię wiadomości do mnie.
- Type: boolean (details)
- token
Token „csrf” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- 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.
- Type: boolean (details)
- showstrategykeys
Whether to include internal merge strategy information in jsconfigvars.
- Type: boolean (details)
- generatexml
- Przestarzałe.
Generate XML parse tree (replaced by prop=parsetree).
- Type: boolean (details)
- 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, zakres IP, nazwa interwiki (np. „prefiks>PrzykładowaNazwa”) oraz ID użytkownika (np. „#12345”)
- namespace
Z jakiej przestrzeni nazw wyświetlać wkład użytkownika.
- Jedna z następujących wartości: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- year
Od roku (i wcześniej).
- Typ: liczba całkowita
- month
Od miesiąca (i wcześniej).
- Typ: liczba całkowita
- tagfilter
Pokaż tylko wkład z tymi znacznikami.
- Wartości (oddziel za pomocą | lub alternatywy): mw-blank, mw-changed-redirect-target, mw-contentmodelchange, mw-manual-revert, mw-new-redirect, mw-removed-redirect, mw-replace, mw-reverted, mw-rollback, mw-server-side-upload, mw-undo
- Domyślnie: (puste)
- deletedonly
Pokazuj tylko usunięty wkład.
- Type: boolean (details)
- toponly
Pokazuj tylko edycje będące ostatnią zmianą strony.
- Type: boolean (details)
- newonly
Pokazuj tylko edycje tworzące stronę.
- Type: boolean (details)
- hideminor
Ukryj drobne zmiany.
- Type: boolean (details)
- showsizediff
Pokaż różnicę rozmiaru między wersjami.
- Type: boolean (details)
- 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.
- feedformat
Format danych wyjściowych.
- Jedna z następujących wartości: atom, rss
- Domyślnie: rss
- namespace
Przestrzeń nazw, do której ograniczone są wyniki.
- Jedna z następujących wartości: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- invert
Wszystkie przestrzenie nazw oprócz wybranej.
- Type: boolean (details)
- associated
Uwzględnij powiązaną przestrzeń nazw (dyskusja lub treść).
- Type: boolean (details)
- days
Dni, do których ograniczone są wyniki.
- Typ: liczba całkowita
- Wartość nie może być mniejsza niż 1.
- Domyślnie: 7
- limit
Maksymalna liczba zwracanych wyników.
- Typ: liczba całkowita
- Wartość musi znajdować się pomiędzy 1 a 50.
- Domyślnie: 50
- from
Pokaż zmiany od tamtej chwili.
- Typ: znacznik czasu (dozwolone formaty)
- hideminor
Ukryj drobne zmiany.
- Type: boolean (details)
- hidebots
Ukryj zmiany zrobione przez boty.
- Type: boolean (details)
- hideanons
Ukryj zmiany zrobione przez anonimowych użytkowników.
- Type: boolean (details)
- hideliu
Ukryj zmiany zrobione przez zarejestrowanych użytkowników.
- Type: boolean (details)
- hidepatrolled
Ukryj sprawdzone zmiany.
- Type: boolean (details)
- hidemyself
Ukryj zmiany zrobione przez obecnego użytkownika.
- Type: boolean (details)
- hidecategorization
Ukryj zmiany w kategoryzacji.
- Type: boolean (details)
- tagfilter
Filtruj po znacznikach.
- target
Pokaż tylko zmiany na stronach linkowanych z tej strony.
- showlinkedto
Pokaż zmiany na stronach linkujących do wybranej strony.
- Type: boolean (details)
- Pokaż ostatnie zmiany.
- api.php?action=feedrecentchanges [otwórz w brudnopisie]
- Pokaż ostatnie zmiany z 30 dni.
- api.php?action=feedrecentchanges&days=30 [otwórz w brudnopisie]
action=feedwatchlist
- Ten moduł wymaga praw odczytu.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
Zwraca kanał listy obserwowanych.
- feedformat
Format kanału.
- Jedna z następujących wartości: atom, rss
- Domyślnie: rss
- hours
Wymień strony zmienione w ciągu tylu godzin licząc od teraz.
- Typ: liczba całkowita
- Wartość musi znajdować się pomiędzy 1 a 72.
- Domyślnie: 24
- linktosections
Linkuj bezpośrednio do zmienionych sekcji jeżeli to możliwe.
- Type: boolean (details)
- allrev
Include multiple revisions of the same page within given timeframe.
- Type: boolean (details)
- wlowner
Used along with token to access a different user's watchlist.
- Typ: użytkownik, podany jako: nazwa użytkownika
- wltoken
A security token (available in the user's preferences) to allow access to another user's watchlist.
- wlshow
Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set show=minor|!anon.
- Wartości (oddziel za pomocą | lub alternatywy): !anon, !autopatrolled, !bot, !minor, !patrolled, !unread, anon, autopatrolled, bot, minor, patrolled, unread
- wltype
Which types of changes to show:
- edit
- Regular page edits.
- new
- Page creations.
- log
- Log entries.
- external
- Zmiany zewnętrzne.
- categorize
- Category membership changes.
- Wartości (oddziel za pomocą | lub alternatywy): categorize, edit, external, log, new
- Domyślnie: edit|new|log|categorize
- wlexcludeuser
Nie wyświetlaj zmian wykonanych przez tego użytkownika.
- Typ: użytkownik, podany jako: nazwa użytkownika, IP, nazwa interwiki (np. „prefiks>PrzykładowaNazwa”) oraz ID użytkownika (np. „#12345”)
- Pokaż kanał listy obserwowanych.
- api.php?action=feedwatchlist [otwórz w brudnopisie]
- Pokaż wszystkie zmiany na obserwowanych stronach dokonane w ciągu ostatnich 6 godzin.
- api.php?action=feedwatchlist&allrev=&hours=6 [otwórz w brudnopisie]
action=filerevert
- Ten moduł wymaga praw odczytu.
- Ten moduł wymaga praw zapisu.
- Ten moduł akceptuje tylko żądania POST.
- Źródło: MediaWiki
- Licencja: GPL-2.0-or-later
Przywróć plik do starej wersji.
- filename
Docelowa nazwa pliku bez prefiksu Plik:
- Ten parametr jest wymagany.
- comment
Prześlij komentarz.
- Domyślnie: (puste)
- archivename
Archive name of the revision to revert to.
- Ten parametr jest wymagany.
- token
Token „csrf” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- Przywróć Wiki.png do wersji z 2011-03-05T15:27:40Z.
- api.php?action=filerevert&filename=Wiki.png&comment=Revert&archivename=20110305152740!Wiki.png&token=123ABC [otwórz w brudnopisie]