API:Tokens (действие)

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:Tokens (action) and the translation is 100% complete.

Other languages:
Deutsch • ‎Deutsch (Sie-Form)‎ • ‎English • ‎dansk • ‎español • ‎português • ‎română • ‎русский • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Начиная с MW 1.24, действие action=tokens устарело и дополнено предупреждением "Следует использовать action=query&meta=tokens".

Токены могут быть получены через action=tokens. Эти токены затем могут быть использованы в других запросах к API.

Параметры

  • type: тип запрашиваемого токена.
    • block
    • delete
    • edit
    • email
    • import
    • move
    • options
    • patrol
    • protect
    • unblock
    • watch

      Расширение Central Auth на серверах MediaWiki добавляет следующие токены:
    • deleteglobalaccount
    • setglobalaccountstatus

Примеры

Getting an edit token (default behavior)

Getting several tokens at once


Возможные ошибки

В дополнение к обычным ошибкам, другие ошибки могут быть возвращены в следующем формате:

<?xml version="1.0"?>
<api>
   <warnings>
      <tokens>Нераспознанное значение параметра <var>type</var>: test.</tokens>
   </warnings>
   <tokens/>
</api>

Возможные ошибки включают:

  • Нераспознанное значение параметра type: value.
  • Действие «xxx» не разрешено для текущего участника.

Если токен не URL-закодирован, может возникнуть ошибка некорректного токена.

Важное замечание

Нужно послать в запросе куки, полученную при входе в учётную запись, когда API вызывается с действием "tokens", иначе будет получена ошибка "readapidenied".