API:トークン

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:Tokens and the translation is 100% complete.

Other languages:
Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎polski • ‎português • ‎română • ‎sicilianu • ‎русский • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
MediaWiki バージョン: 1.24

API:トークンモジュールにより、ログ取得、ページの編集や移動、更新の監視や巡回などのデータ改変を伴う処理に必要なトークンが支給されます。 処理のたびに特定のタイプのトークンを用意します。 一例:Action API経由で特定のウィキサイトにログインしたい場合、「login」タイプのトークンを用意して処理を進めます。

APIの説明文書




meta=tokens

(main | query | tokens)

Gets tokens for data-modifying actions.

Parameter:
type

Types of token to request.

Values (separate with | or alternative): createaccount, csrf, deleteglobalaccount, login, patrol, rollback, setglobalaccountstatus, userrights, watch
Default: csrf
Examples:
Retrieve a csrf token (the default).
api.php?action=query&meta=tokens [open in sandbox]
Retrieve a watch token and a patrol token.
api.php?action=query&meta=tokens&type=watch|patrol [open in sandbox]

GET リクエスト

レスポンス

{
    "batchcomplete": "",
    "query": {
        "tokens": {
            "logintoken": "9ed1499d99c0c34c73faa07157b3b6075b427365+\\"
        }
    }
}

サンプル コード

Tokens.py

/* 

 #!/usr/bin/python3

"""
    tokens.py

    MediaWiki Action API Code Samples
    Demo of `Token` module: Fetch token of type `login`
    MIT license
"""

import requests

S = requests.Session()

URL = "https://mediawiki.org/w/api.php"

PARAMS = {
    'action':"query",
    'meta':"tokens",
    'type':"login",
    'format':"json"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

LOGIN_TOKEN = DATA['query']['tokens']['logintoken']

print(LOGIN_TOKEN)

起こりうるエラー

コード 情報
Unrecognized value for parameter "type": xxx Token type 'xxx is not valid

パラメータの履歴

  • v1.27: login, createaccount を導入しました

関連項目