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 64% 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

      The Central Auth extension on MediaWiki servers adds the following tokens:
    • deleteglobalaccount
    • setglobalaccountstatus

Getting an edit token (default behavior)

Getting several tokens at once


起こりうるエラー

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

<?xml version="1.0"?>
<api>
   <warnings>
      <tokens>Unrecognized value for parameter <var>type</var>: test.</tokens>
   </warnings>
   <tokens/>
</api>

以下のエラーが発生する場合があります:

  • Unrecognized value for parameter type: value.
  • Action "xxx" is not allowed for the current user.

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.