Справка 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

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

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

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

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Linkaccount

Определённые параметры:

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 (или предыдущий ответ этого модуля, если доступен) для определения, какие запросы доступны и какие поля они используют.

Пример:

Начать связывание учётной записи с Example.: api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [открыть в песочнице]