Довідка API MediaWiki
Це автоматично генерована сторінка документації API MediaWiki.
Документація та приклади: https://www.mediawiki.org/wiki/API
action=createaccount (create)
- Цей модуль вимагає прав на запис.
- Цей модуль приймає лише POST-запити.
- Джерело: MediaWiki
- Ліцензія: GPL-2.0+
Створити новий обліковий запис користувача.
Загальна процедура використання цього модуля така:
- Отримайте доступні поля зі action=query&meta=authmanagerinfo за допомогою amirequestsfor=create, а також токен createaccount зі action=query&meta=tokens.
- Передайте ці поля користувачеві, і отримайте інформацію, якою він їх заповнить.
- Напишіть до цього модуля, заповнивши createreturnurl та всі релевантні поля.
- Перевірте status у відповіді.
- Якщо Ви отримали PASS або FAIL, роботу завершено. Операція або була успішною, або провалилася.
- Якщо Ви отримали UI, надішліть нові поля користувачеві й отримайте інформацію, якою він їх заповнить. Далі напишіть до цього модуля із createcontinue та заповніть всі реелевантні поля, після чого повторіть крок 4.
- Якщо Ви отримали REDIRECT, направте користувача до redirecttarget і дочекайтеся повернення до createreturnurl. Тоді напишіть до цього модуля із createcontinue, та з усіма полями, що були передані до повернутої URL-адреси, після чого повторіть крок 4.
- Якщо Ви отримали RESTART, це означає, що автентифікація спрацювала, але ми не маємо пов'язаного облікового запису користувача. Ви можете розцінити це як UI, або як FAIL.
- createrequests
Використовувати ці автентифікаційні запити через id, що повертається з action=query&meta=authmanagerinfo за допомогою amirequestsfor=create, або з попередньої відповіді з цього модуля.
- Розділіть значення з допомогою | або альтернативу. Максимальна кількість значень — 50 (500 для ботів).
- createmessageformat
Формат до використання для повернення повідомлень.
- Одне з наступних значень: html, wikitext, raw, none
- За замовчуванням: wikitext
- createmergerequestfields
Об'єднати інформацію всіх автентифікаційних запитів у один масив.
- Тип: логічний (деталі)
- createpreservestate
Зберегти статус з попередньої спроби входу, що не вдалась, якщо можливо.
Якщо запит action=query&meta=authmanagerinfo повернув істину для hasprimarypreservedstate, запити позначені як primary-required повинні бути пропущені. Якщо він повернув не порожнє значення для preservedusername, це ім'я користувача повинно бути використано для параметру username.
- Тип: логічний (деталі)
- createreturnurl
URL-адреса повернення для сторонніх автентифікаційних потоків повинна бути абсолютною. Обов'язковим є це, або createcontinue.
При отриманні відповіді REDIRECT, найбільш звичною Вашою дією буде відкриття браузерного чи іншого веб-перегляду вказаного URL-посилання для стороннього потоку автентифікації. Коли ця операція буде завершена, стороння програма перенаправить веб-переглядач на цю URL-адресу. Ви повинні видобувати будь-які параметри запитів або POST-параметри із цієї URL-адреси, і передавати їх як запит createcontinue до цього модуля API.
- createcontinue
Цей запит є продовженням після попередньої відповіді UI або REDIRECT. Або це, або createreturnurl є обов'язковим.
- Тип: логічний (деталі)
- createtoken
Токен «createaccount» отримано з action=query&meta=tokens
- Цей параметр є обов'язковим.
- *
- Цей модуль приймає додаткові параметри, залежно від доступних автентифікаційних запитів. Використовуйте action=query&meta=authmanagerinfo за допомогою amirequestsfor=create (або попередню відповідь від цього модуля, якщо це застосовно), аби визначити доступні запити та поля, які вони використовують.
- Почати процес створення користувача Example з паролем ExamplePassword.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [відкрити в пісочниці]