API:Ověření

Verze MediaWiki:

≥ 1.23

Parametr assert parametr Action API může být nastaven na jakýkoli požadavek API pro ověření určitých podmínek před provedením požadované akce.

Dostupné možnosti jsou:

• assert=anon: Zkontrolujte, zda jednáte jako IP uživatel . Tím se zabrání náhodnému použití registrovaného účtu. Od MW 1.35 Gerrit change 572374
• assert=user: Zkontrolujte, zda používáte registrovaný účet (buď "pojmenovaný" nebo dočasný). Tím se zabrání náhodnému návratu k uživateli IP.
• assert=bot: Zkontrolujte, zda jste přihlášeni pomocí účtu, který má uživatelské právo "bot ". To zabrání vašemu skriptu v interakci s wikinami, kde váš robot nemá příznak bota.
• assertuser=...: Zkontrolujte, zda jste přihlášeni s očekávaným uživatelským jménem. Od MW 1.28

Všimněte si, že dočasní uživatelé splňují assert=user a neuspějí assert=anon.

Možné chyby

Pokud tvrzení selže, bude vrácen jeden z následujících chybových kódů:

• assertanonfailed
• assertuserfailed
• assertbotfailed
• assertnameduserfailed

Odůvodnění a případy použití

Tyto parametry jsou určeny jako druhá linie obrany proti dvěma druhům problémů:

Chyby operátora robota

Jednoduchá chyba operátora snadno způsobí mnoho špatných úprav, jako je například běh robota na nesprávné wiki nebo pod nesprávným uživatelským jménem, zvláště pokud spouštíte více úloh robota. Parametry assert=bot a assertuser=... mají těmto chybám zabránit.

Vypršení platnosti relace přihlášení

Po přihlášení jsou soubory cookie, které obdržíte, platné pouze 30 dní ve výchozím nastavení, po této době bude váš robot odhlášen a může pokračovat v práci s jeho akcemi, které jsou atributy IP adresy nebo dočasného uživatelského jména (pokud je mohou provádět odhlášení uživatelé). Parametr assert=user tomu má zabránit.

Přepínání uživatelských účtů

Interaktivní nástroje (v prohlížeči) využívající API k úpravám často chtějí zajistit, aby uživatel pochopil, jak bude jeho práce připisována. Když se uživatel přihlásí nebo odhlásí na jiné kartě prohlížeče (nebo vyprší platnost jeho přihlašovací relace), neprojeví se to okamžitě v rozhraní nástroje, ale nová přihlašovací relace bude použita pro ukládání akcí. Parametry assertuser=... a assert=anon mají umožnit detekci tohoto scénáře a zobrazení příslušné zprávy před pokračováním.

Ověření, zda-li jste přihlášení

Pokud chcete zkontrolovat, zda je váš HTTP klient přihlášen do Action API, aniž byste provedli jakoukoli jinou akci, můžete odeslat požadavek s parametry action=query&assert=user. To vrátí prázdnou odpověď ({} ve formátu JSON), pokud jste skutečně přihlášeni, nebo chybu assertuserfailed, pokud ne.

Za normálních okolností nebudete muset provádět samostatný požadavek, jako je tento. Místo toho u každého požadavku nastavte parametr assert=user.