Довідка API MediaWiki

Це автоматично генерована сторінка документації API MediaWiki.

Документація та приклади: https://www.mediawiki.org/wiki/API

action=createaccount (create)

(maincreateaccount)
  • Цей модуль вимагає прав на запис.
  • Цей модуль приймає лише POST-запити.
  • Джерело: MediaWiki
  • Ліцензія: GPL-2.0+

Створити новий обліковий запис користувача.

Загальна процедура використання цього модуля така:

  1. Отримайте доступні поля зі action=query&meta=authmanagerinfo за допомогою amirequestsfor=create, а також токен createaccount зі action=query&meta=tokens.
  2. Передайте ці поля користувачеві, і отримайте інформацію, якою він їх заповнить.
  3. Напишіть до цього модуля, заповнивши createreturnurl та всі релевантні поля.
  4. Перевірте 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 [відкрити в пісочниці]