API:令牌（操作）

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

关于当前通过元模块获取令牌的方法，参见：API:Tokens。

action=tokens在MW 1.24 中被弃用，并在 1.37 中被删除。 請使用action=query&meta=tokens。 (See API:令牌 .)

可以使用action=tokens获取令牌。然后可以在其他API请求中使用这些令牌。

参数

• type： 请求的令牌类型。
  • block
  • delete
  • edit
  • email
  • import
  • move
  • options
  • patrol
  • protect
  • rollback
  • unblock
  • watch
    
    MediaWiki服务器上的中央身份验证扩展添加了以下令牌：
  • deleteglobalaccount
  • setglobalaccountstatus

示例

Getting an edit token (default behavior)

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

结果
<?xml version="1.0"?> <api> <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" /> </api>

Getting several tokens at once

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

结果
<?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⧽

未能urlencode令牌可能会导致令牌无效错误。

重要提醒

调用带有“tokens”动作的接口时，需要发送登录阶段获取的cookie，否则会出现隐晦的“Readapdened”错误。