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

tokens
Gets tokens for data-modifying actions. Этот модуль не может быть использован в качестве генератора.
Префикс
Необходимые права	нет
Только POST?	Нет
Генерируемая справка	Текущее
Добавлено в версии	≥ 1.20

Для текущего метода получения токенов через модуль meta, см.: API:Tokens.

action=tokens was deprecated in MW 1.24 and removed in 1.37. Use action=query&meta=tokens instead. (See API:Токены .)

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

Параметры

• type: тип запрашиваемого токена.
  • block
  • delete
  • edit
  • email
  • import
  • move
  • options
  • patrol
  • protect
  • rollback
  • unblock
  • watch
    
    Расширение Central Auth на серверах MediaWiki добавляет следующие токены:
  • deleteglobalaccount
  • setglobalaccountstatus

Примеры

Getting an edit token (default behavior)

api.php?action=tokens [попробуйте в ApiSandbox]

Результат
<?xml version="1.0"?> <api> <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" /> </api>

Getting several tokens at once

api.php?action=tokens&type=edit|email|patrol|watch [попробуйте в ApiSandbox]

Результат
<?xml version="1.0"?> <api> <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" emailtoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" patroltoken="0eaa2666f8c6c0779c43acbdf9703c4a+\" watchtoken="22dff2c0b0c1bef9ad34673b81b91f22+\" /> </api>

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

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

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

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

• Нераспознанное значение параметра type: value.
• ⧼apiwarn-tokennotallowed⧽

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

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

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