MediaWiki API súgó

Ez egy automatikusan generált MediaWiki-API-dokumentációs lap.

Dokumentáció és példák: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=block

(main | block)
  • Ez a modul olvasási jogot igényel.
  • Ez a modul írási jogot igényel.
  • Ez a modul csak POST kéréseket fogad el.
  • Forrás: MediaWiki
  • Licenc: GPL-2.0-or-later

Egy felhasználó blokkolása.

Jellemző paraméterek:
Other general parameters are available.
id

A módosítandó blokk azonosítója (a list=blocksszal kérhető le). Nem használható együtt a user, reblock vagy newblock paraméterrel.

Típus: egész szám
user

A blokkolandó felhasználó. Nem használható a(z) id paraméterrel együtt.

Típus: felhasználó, a következők egyikével megadva: felhasználónév, IP-cím, Ideiglenes felhasználó, IP-tartomány és felhasználóazonosító (pl. "#12345")
userid
Elavult.

Használd helyette a user=#ID paramétert.

Típus: egész szám
expiry

Lejárat ideje. Lehet relatív (pl. 5 months, 2 weeks) vagy abszolút (pl. 2014-09-18T12:34:56Z). Ha infinite-re, indefinite-re vagy never-re állítod, a blokk soha nem fog lejárni.

Alapértelmezett: never
reason

Blokkolás oka.

Alapértelmezett: (üres)
anononly

Csak anonim felhasználók blokkolása (anonim szerkesztések megakadályozása erről az IP-címről, beleértve az ideiglenes felhasználók szerkesztéseit).

Típus: logikai (részletek)
nocreate

Új regisztráció megakadályozása

Típus: logikai (részletek)
autoblock

Az utoljára használt IP-cím blokkolása, valamint bármilyen további IP-cím, amiről a felhasználó megpróbál bejelentkezni.

Típus: logikai (részletek)
noemail

A wiki e-mail-küldő rendszerének letiltása a felhasználó számára (blockemail jogosultság szükséges hozzá).

Típus: logikai (részletek)
hidename

A felhasználónév elrejtése a blokknaplóból (hideuser jog szükséges hozzá).

Típus: logikai (részletek)
allowusertalk

A felhasználó szerkeszthesse a saját vitalapját (a $wgBlockAllowsUTEdit beállítástól függ).

Típus: logikai (részletek)
reblock

Jelenlegi blokk felülírása, ha a felhasználónak már van pontosan egy blokkja. Ha a felhasználónak egynél több aktív blokkja van, ez a paraméter hibát fog okozni – helyette használd az id paramétert a felülírandó blokk megadásához. Nem használható együtt az id vagy newblock paraméterrel.

Típus: logikai (részletek)
newblock

Újabb blokk hozzáadása, ha a felhasználó már blokkolva van. Nem használható együtt az id vagy reblock paraméterrel.

Típus: logikai (részletek)
watchuser

A felhasználó vagy IP-cím felhasználói és vitalapjának figyelése.

Típus: logikai (részletek)
tags

A blokknapló naplóbejegyzésére érvényesítendő változtatáscímkék.

Értékek (elválasztó: | vagy más):
partial

Teljes blokk helyett a felhasználó eltiltása bizonyos lapok vagy névterek szerkesztésétől.

Típus: logikai (részletek)
pagerestrictions

A felhasználó számára blokkolandó címek listája. Csak akkor van hatása, ha a partial igaz.

Típus: lapcím
Az értékékeket a | karakterrel vagy az alternatív elválasztóval válaszd el.
Az értékek maximális száma 10.
Csak létező oldalakat fogad el
namespacerestrictions

List of namespace IDs to block the user from editing. Only applies when partial is set to true.

Értékek (elválasztó: | vagy más): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 828, 829
Az összes érték megadásához használd a(z) * értéket.
actionrestrictions

List of actions to block the user from performing. Only applies when partial is set to true.

Értékek (elválasztó: | vagy más): create, move, upload
token

Egy „csrf” token, az action=query&meta=tokens kéréssel lekérve

Ez a paraméter kötelező.
Példák:
A 192.0.2.5 IP-cím blokkolása három napra indoklással.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [megnyitás a homokozóban]
Vandal blokkolása határozatlan időre indoklással, új fiók létrehozásának és e-mail küldésének megakadályozása.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [megnyitás a homokozóban]