API:Tokens (действие)
Эта страница является частью документации по API действий MediaWiki. |
tokens | ||
---|---|---|
Gets tokens for data-modifying actions. Этот модуль не может быть использован в качестве генератора. | ||
Префикс | ||
Необходимые права | нет | |
Только POST? | Нет | |
Генерируемая справка | Текущее | |
Добавлено в версии |
|
Для текущего метода получения токенов через модуль 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)
Результат |
---|
<?xml version="1.0"?>
<api>
<tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" />
</api>
|
Getting several tokens at once
Результат |
---|
<?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".