Справка MediaWiki API
Это автоматически сгенерированная страница документации MediaWiki API.
Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=createaccount (create)
- Этот модуль требует прав на запись.
- Этот модуль принимает только POST-запросы.
- Источник: MediaWiki
- Лицензия: GPL-2.0-or-later
Создание новой учётной записи.
Стандартная процедура использования этого модуля такова:
- Запрос полей, доступных из action=query&meta=authmanagerinfo с amirequestsfor=create, и токена createaccount из action=query&meta=tokens.
- Предоставление полей пользователю и получение его данных.
- Запрос к этому модулю, содержащий createreturnurl или аналогичное поле.
- Проверка поля status ответа.
- Если вы получили PASS или FAIL, вы закончили. Операция либо завершилась успехом, либо нет.
- Если вы получили UI, предоставьте новые поля пользователю и получите новые данные. Затем совершите новый запрос с параметром createcontinue и новыми полями, после чего повторите пункт 4.
- Если вы получили REDIRECT, отправьте пользователя на redirecttarget и подождите возвращения на createreturnurl. Затем совершите запрос к этому модулю с параметром createcontinue и всеми полями, содержащимися в возвращённой ссылке, и повторите пункт 4.
- Если вы получили RESTART, это означает, что аутентификация работает, но мы не привязали пользовательский аккаунт. Вы можете рассматривать это как UI или FAIL.
- createrequests
Использовать только эти аутентификационные запросы, с id, возвращённом из action=query&meta=authmanagerinfo с amirequestsfor=create, или из предыдущего ответа этого модуля.
- Разделяйте значения с помощью | или альтернативного разделителя.
- Максимальное количество значений — 50 (500 для клиентов, которым разрешены более высокие лимиты).
- createmessageformat
Формат, используемый для возвращаемых сообщений.
- Одно из следующих значений: html, none, raw, wikitext
- По умолчанию: wikitext
- createmergerequestfields
Слить поля информации со всех аутентификационных запросов в один массив.
- Type: boolean (details)
- createpreservestate
Сохранить состояние с предыдущей провалившейся попытки авторизации, если возможно.
Если запрос action=query&meta=authmanagerinfo возвращает true для hasprimarypreservedstate, то запросы, отмеченные как primary-required, должны быть пропущены. Если запрос возвращает непустое значение поля preservedusername, то это значение должно быть использовано в параметре username.
- Type: boolean (details)
- createreturnurl
Вернуть ссылку для стороннего процесса аутентификации, должна быть абсолютной. Либо этот параметр, либо createcontinue, обязателен.
После получения ответа REDIRECT, вы, как правило, должны открыть в браузере или вэб-просмотрщике указанную в redirecttarget ссылку для продолжения стороннего процесса аутентификации. По завершению, сторонний сервис отошлёт браузеру или веб-просмотрщику эту ссылку. Вы должны извлечь все параметры из ссылки и отослать их в параметр createcontinue запроса к этому модулю.
- createcontinue
Этот запрос — продолжение после предшествующего ответа UI или REDIRECT. Либо этот параметр, либо createreturnurl, обязателен.
- Type: boolean (details)
- 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 [открыть в песочнице]