API:令牌（操作）

MediaWiki Action API
基础 所有查询模块 获取页面属性 列举匹配标准的页面 获取模块参数信息 获取有关wiki和用户的元信息 认证 获取用于数据修改操作的令牌 登录 退出 账户和用户 创建账户 封禁与解封用户 Get info about the current user 获取当前用户的监视列表作为订阅源 更改用户选项 更改用户组成员 发送邮件 页面操作 解析页面的内容 创建和编辑页面 上传文件 导入页面 删除页面 监视页面与取消监视页面 清除页面缓存 回退页面 移动页面 巡查页面或修订版本 还原已删除页面的修订版本 更改页面的保护级别 更改页面的语言 更多... 搜索 搜索标题或文本 检索开放搜索格式中的结果 搜索某一位置附近的wiki页面 搜索页面 执行页面标题的前缀搜索 开发员公用 访问库 跨站请求 在扩展中创建API模块 在MediaWiki与扩展中使用API 限制API使用 本地化 Implementation Strategy Tutorials Action API Tutorial Article ideas generator Nearby places viewer Picture of the day viewer

tokens
Gets tokens for data-modifying actions. 此模块不能用作Generator 。
前缀
需要的权限	无
仅限Post？	否
产生帮助	当前
添加的版本	≥ 1.20

For the current method of obtaining tokens via a meta module, see: API:Tokens

Since MW 1.24, the action=tokens is deprecated and includes a warning "Please use action=query&meta=tokens instead".

Tokens can be obtained using action=tokens. These tokens can then be used in other API requests.

参数

• type: the type of token requested.
  • block
  • delete
  • edit
  • email
  • import
  • move
  • options
  • patrol
  • protect
  • unblock
  • watch
    
    The Central Auth extension on MediaWiki servers adds the following tokens:
  • deleteglobalaccount
  • setglobalaccountstatus

示例

Getting an edit token (default behavior)

api.php?action=tokens [在Api沙盒中尝试]

Getting several tokens at once

api.php?action=tokens&type=edit|email|patrol|watch [在Api沙盒中尝试]

可能的错误

In addition to the usual errors, other errors may be returned in the following format:

<?xml version="1.0"?>
<api>
   <warnings>
      <tokens>无法识别的参数<var>type</var>的值：test。</tokens>
   </warnings>
   <tokens/>
</api>

可能的错误包括：

• 无法识别的参数type的值：value。
• 操作“xxx”不允许当前用户使用。

Failing to urlencode the token can result in an invalid token error.

重要提醒

You need to send the cookie obtained in the login phase when you call the api with the "tokens" action; otherwise you get the cryptic "readapidenied" error.