Довідка API MediaWiki

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

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

action=linkaccount (link)

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

Пов'язати обліковий запис третьої сторони з поточним користувачем.

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

  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, та з усіма полями, що були передані до повернутої URL-адреси, після чого повторіть крок 4.
    • Якщо Ви отримали RESTART, це означає, що автентифікація спрацювала, але ми не маємо пов'язаного облікового запису користувача. Ви можете розцінити це як UI, або як FAIL.
Параметри:
linkrequests

Використовувати ці автентифікаційні запити через id, що повертається з action=query&meta=authmanagerinfo за допомогою amirequestsfor=link, або з попередньої відповіді з цього модуля.

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

Формат до використання для повернення повідомлень.

Одне з наступних значень: html, wikitext, raw, none
За замовчуванням: wikitext
linkmergerequestfields

Об'єднати інформацію всіх автентифікаційних запитів у один масив.

Тип: логічний (деталі)
linkreturnurl

URL-адреса повернення для сторонніх автентифікаційних потоків повинна бути абсолютною. Обов'язковим є це, або linkcontinue.

При отриманні відповіді REDIRECT, найбільш звичною Вашою дією буде відкриття браузерного чи іншого веб-перегляду вказаного URL-посилання для стороннього потоку автентифікації. Коли ця операція буде завершена, стороння програма перенаправить веб-переглядач на цю URL-адресу. Ви повинні видобувати будь-які параметри запитів або POST-параметри із цієї URL-адреси, і передавати їх як запит linkcontinue до цього модуля API.

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 [відкрити в пісочниці]