API:Login/uk

API MediaWiki може вимагати від вашої програми або клієнта надання автентифікованих облікових даних користувача та входу для (a) запиту інформації або дій, що модифікують дані (b) для створення великих запитів із вищим обмеженням кількості запитів.



Два методи автентифікації
Є два способи автентифікації за допомогою MediaWiki Action API:



Метод 1. login
Боти та інші неінтерактивні програми повинні використовувати метод тільки для власників споживачів OAuth, якщо вони доступні, оскільки це безпечніше. Якщо метод недоступний або незастосовний до клієнта, то можна використати дію  з паролем бота.



Приклад


Відповідь


Приклад коду


Можливі помилки


Метод 2. clientlogin
Інтерактивні програми, такі як користувацькі редактори або додатки для патрулювання, які надають послугу, не маючи наміру повністю замінити веб-сайт або мобільні програми, які мають на меті повністю замінити доступ до веб-інтерфейсу користувача, повинні використовувати дію. Однак треба надавати перевагу використанню, якщо він доступний для автентифікації інструменту, оскільки він простіший і безпечніший. Цей модуль доступний починаючи з MediaWiki 1.27.



Документація API


Приклад 1: Обробка вікі без спеціальних розширень автентифікації


Запит POST
Отримайте токен логіна у наведеному вище запиті через.

Відповідь


Приклад коду


Приклад 2: Обробка вікі з спеціальними розширеннями автентифікації
Вікі зі спеціальними розширеннями автентифікації, такими як (капчі),,  (двофакторна автентифікація), може мати складніший процес автентифікації. У цьому разі можуть також знадобитися конкретні поля, опис яких можна отримати з запиту.

Step 3: Two-factor authentication


Додаткові примітки

 * На вікі, які дозволяють анонімне редагування, можна редагувати за допомогою API без входу, але настійно рекомендується ввійти в систему. На приватних вікі вхід необхідний, щоб використовувати будь-яку функціональність API.
 * Рекомендується створити окремий обліковий запис користувача для вашої програми. Це особливо важливо, якщо ваш додаток виконує автоматичне редагування або викликає великі запити, що вимагають великої продуктивності. Завдяки цьому легко відстежувати зміни, внесені програмою, та застосовувати спеціальні права до облікового запису програми. This is especially important if your application is carrying out automated editing or invoking large or performance-intensive queries. With that, it is easy to track changes made by the application and apply special rights to the application's account.
 * Якщо ви надсилаєте запит, який повинен зробити зареєстрований користувач, додайте параметр  до запиту, який ви надсилаєте, щоб перевірити, чи ввійшов користувач. Якщо користувач не ввійшов у систему, буде повернуто код помилки.
 * Щоб перевірити, чи має обліковий запис права бота, додайте до запиту параметр . Якщо обліковий запис не має прав бота, буде повернуто код помилки.



Див. також

 * - Повертає інформацію про поточного користувача, який увійшов до системи
 * Interactive login with action=clientlogin in mwapi
 * Interactive login with action=clientlogin in mwapi