API:Tokens/it

This page is a translated version of the page API:Tokens and the translation is 17% complete.

Languages:

Questa pagina fa parte della documentazione MediaWiki API.

Azione MediaWiki API
Nozioni di base
Etichette e linee guida per l'uso Interrogazioni Ottenere le proprietà delle pagine Elenco delle pagine che corrispondono a un criterio Ottenere le metainformazioni sulle wiki e sull'utente Output formats
Autenticazione
Ottenere i token per le operazioni di modifica dei dati Accesso Logout Verifying authentication (assertions)
Account e utenti
Crea un account (S)blocca utenti Ottenere informazioni sull'utente corrente Ottenere la watchlist dell'utente corrente come feed Opzioni utente Cambia il tipo di membership del gruppo Invia email
Pagina Operazioni
Crea e modifica pagine Get the contents of a page Carica files Importa pagine Elimina pagine Confrontare wikitext ed espandere templates Guardare o non guardare una pagina Eliminare la cache per le pagine Rollback di una pagina Sposta pagine Controlla una pagina o una revisione Ripristina revisioni eliminate Pagine (non) protette Cambiare la lingua di una pagina Altro...
Cerca
Ricerca di pagine wiki per titolo (OpenSearch) Ricerca avanzata delle pagine wiki per titolo o testo Cercare le pagine wiki vicino a un luogo Ricerca per il nome di lingua Eseguire una ricerca per prefisso dei titoli delle pagine
Utilità per gli sviluppatori
Accesso alle librerie Cross-site requests Creare un modulo API in un'estensione Usa le API in MediaWiki e nelle estensioni Restricting API usage Localisation Implementation Strategy
Tutorial
Tutorial dell'API di azioni Article ideas generator Nearby places viewer Picture of the day viewer Holidays viewer
v · d · e

Versione MediaWiki:

≥ 1.24

API:Tokens module provide tokens required by data-modifying actions such as logging, editing or moving a page, and watching or patrolling changes. For each action, you need a specific type of token. For example: if you want to login to a wiki site via the Action API, you would need a token of type "login" to proceed.

For help in migrating older code, refer to Deprecation of legacy API token parameters

API documentation

The following documentation is the output of Special:ApiHelp/query+tokens, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).

meta=tokens

(main | query | tokens)

Source: MediaWiki
License: GPL-2.0-or-later

Gets tokens for data-modifying actions.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Tokens

Specific parameter:

Other general parameters are available.

type: Types of token to request.; Values (separate with | or alternative): createaccount, csrf, deleteglobalaccount, login, patrol, rollback, setglobalaccountstatus, userrights, watch; To specify all values, use *.; 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]

Esempio

GET request

api.php?action=query&meta=tokens&format=json&type=login [prova in ApiSandbox]

Response

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

Sample code

Python

#!/usr/bin/python3
"""
 tokens.py
 MediaWiki API Demos
 Demo of `Token` module: Fetch token of type `login`
 MIT License
"""
import requests
S = requests.Session()
URL = "https://www.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)

PHP

<?php
/*
 tokens.php
 MediaWiki API Demos
 Demo of `Token` module: Fetch token of type `login`
 MIT License
*/
$endPoint = "https://www.mediawiki.org/w/api.php";
$params = [
 "action" => "query",
 "meta" => "tokens",
 "type" => "login",
 "format" => "json"
];
$url = $endPoint . "?" . http_build_query( $params );
$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );
$result = json_decode( $output, true );
echo( $result['query']['tokens']['logintoken'] . "\n" );

Perl

#!/usr/bin/perl
# token.pl
# MediaWiki API Demos
# Demo of `Token` module: Fetch token of type `login`
# WTFPL
usestrict;
usewarnings;
useJSON;
useLWP::UserAgent;
useURI;
my$url=URI->new('https://www.mediawiki.org/w/api.php');
my%params=(
'action'=>'query',
'meta'=>'tokens',
'type'=>'login',
'format'=>'json',
);
$url->query_form(%params);
my$ua=LWP::UserAgent->new();
my$response=$ua->get($url);
my$data=JSON::decode_json($response->content);
my$login_token=$data->{'query'}{'tokens'}{'logintoken'};
print"$login_token\n";

Node.js

/*
 tokens.js
 MediaWiki API Demos
 Demo of `Token` module: Fetch token of type `login`
 MIT License
*/
varrequest=require('request'),
url="https://www.mediawiki.org/w/api.php";
varparams={
action:"query",
meta:"tokens",
type:"login",
format:"json"
};
request.get({url:url,qs:params},function(error,response,body){
body=JSON.parse(body);
console.log(body.query.tokens.logintoken);
});

MediaWiki JS

/*
 tokens.js
 MediaWiki API Demos
 Demo of `Token` module: Fetch token of type `csrf`
 MIT License
*/
varparams={
action:'query',
meta:'tokens',
type:'csrf',
format:'json'
},
api=newmw.Api();
api.get(params).done(function(data){
console.log(data.query.tokens.csrftoken);
});