Справка MediaWiki API

Это автоматически сгенерированная страница документации MediaWiki API.

Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=linkaccount (link)

(main | linkaccount)
  • Этот модуль требует прав на запись.
  • Этот модуль принимает только POST-запросы.
  • Источник: MediaWiki
  • Лицензия: GPL-2.0-or-later

Связать учётную запись третьей стороны с текущим участником.

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

  1. Запрос полей, доступных из action=query&meta=authmanagerinfo с amirequestsfor=link, и токена csrf из action=query&meta=tokens.
  2. Предоставление полей пользователю и получение его данных.
  3. Запрос к этому модулю, содержащий linkreturnurl или аналогичное поле.
  4. Проверка поля status ответа.
    • Если вы получили PASS или FAIL, вы закончили. Операция либо завершилась успехом, либо нет.
    • Если вы получили UI, предоставьте новые поля пользователю и получите новые данные. Затем совершите новый запрос с параметром linkcontinue и новыми полями, после чего повторите пункт 4.
    • Если вы получили REDIRECT, отправьте пользователя на redirecttarget и подождите возвращения на linkreturnurl. Затем совершите запрос к этому модулю с параметром linkcontinue и всеми полями, содержащимися в возвращённой ссылке, и повторите пункт 4.
    • Если вы получили RESTART, это означает, что аутентификация работает, но мы не привязали пользовательский аккаунт. Вы можете рассматривать это как UI или FAIL.
Определённые параметры:
Other general parameters are available.
linkrequests

Использовать только эти аутентификационные запросы, с id, возвращённом из action=query&meta=authmanagerinfo с amirequestsfor=link, или из предыдущего ответа этого модуля.

Разделяйте значения с помощью | или альтернативного разделителя.
Максимальное количество значений — 50 (500 для клиентов, которым разрешены более высокие лимиты).
linkmessageformat

Формат, используемый для возвращаемых сообщений.

Одно из следующих значений: html, none, raw, wikitext
По умолчанию: wikitext
linkmergerequestfields

Слить поля информации со всех аутентификационных запросов в один массив.

Тип: булева (подробнее)
linkreturnurl

Вернуть ссылку для стороннего процесса аутентификации, должна быть абсолютной. Либо этот параметр, либо linkcontinue, обязателен.

После получения ответа REDIRECT, вы, как правило, должны открыть в браузере или вэб-просмотрщике указанную в redirecttarget ссылку для продолжения стороннего процесса аутентификации. По завершению, сторонний сервис отошлёт браузеру или веб-просмотрщику эту ссылку. Вы должны извлечь все параметры из ссылки и отослать их в параметр linkcontinue запроса к этому модулю.

linkcontinue

Этот запрос — продолжение после предшествующего ответа UI или REDIRECT. Либо этот параметр, либо linkreturnurl, обязателен.

Тип: булева (подробнее)
linktoken

Токен «csrf», полученный из action=query&meta=tokens

Это обязательный параметр.
*
Этот модуль принимает дополнительные параметры в зависимости от доступных аутентификационных запросов. Используйте action=query&meta=authmanagerinfo с amirequestsfor=link (или предыдущий ответ этого модуля, если доступен) для определения, какие запросы доступны и какие поля они используют.