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.
- 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ę
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.
- 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-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, 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łó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=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.
- 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
- 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ć.
- filter
Pełny tekst filtru do sprawdzenia zgodności składni.
- Ten parametr jest wymagany.
- Sprawdź składnię poprawnego filtra
- api.php?action=abusefilterchecksyntax&filter="foo" [otwórz w brudnopisie]
- Sprawdź składnię nieprawidłowego filtra
- api.php?action=abusefilterchecksyntax&filter="bar"%20bad_variable [otwórz w brudnopisie]
action=abusefilterevalexpression
- Ten moduł wymaga praw odczytu.
- Źródło: Abuse Filter
- Licencja: GPL-2.0-or-later
Ewaluuje wyrażenie filtra nadużyć.
- expression
Wyrażenie do sprawdzenia.
- Ten parametr jest wymagany.
- prettyprint
Czy wynik powinien zostać sformatowany.
- Typ: wartość boolowska (szczegóły)
- Ewaluuj proste wyrażenie
- api.php?action=abusefilterevalexpression&expression=lcase("FOO") [otwórz w brudnopisie]
- Ewaluuj proste wyrażenie, formatując wynik
- api.php?action=abusefilterevalexpression&expression=lcase("FOO")&prettyprint=1 [otwórz w brudnopisie]
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ć.
- 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.
- Zdejmij blokadę autopromocji z User:Example
- api.php?action=abusefilterunblockautopromote&user=Example&token=123ABC [otwórz w brudnopisie]
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ć.
- 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.
- 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.
- 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)
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.
- 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.
- 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: 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.
- 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=chatgetnew
- Ten moduł wymaga praw odczytu.
- Źródło: MediaWikiChat
- Licencja: GPL-2.0-or-later
Get new messages in the chat.
- focussed
is the chat tab open/focused right now?
- Typ: wartość boolowska (szczegóły)
- 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
- id
The user ID to kick
- Ten parametr jest wymagany.
- Typ: liczba całkowita
- 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
- message
Wiadomość do wysłania
- Ten parametr jest wymagany.
- Send "Hello World!" to the chat
- api.php?action=chatsend&message=Hello%20World! [otwórz w brudnopisie]
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
- 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
- Send "Hello World!" to user with ID 5
- api.php?action=chatsendpm&id=5&message=Hello%20World! [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.
- 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): 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
- 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.
- 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=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.
- 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.
- delete comment with page ID 3
- api.php?action=csdeletecomment&pageid=3 [otwórz w brudnopisie]
- delete comment with page title CommentStreams:3
- api.php?action=csdeletecomment&title=CommentStreams:3 [otwórz w brudnopisie]