API:パスワード検証
このページは MediaWiki 操作 API の説明文書の一部です。 |
パスワードがウィキのパスワードの方針に合致しているか検証する POST リクエストです。
MediaWiki バージョン: | ≧ 1.29 |
APIの説明文書
action=validatepassword(main | validatepassword)
Validate a password against the wiki's password policies. Validity is reported as Good if the password is acceptable, Change if the password may be used for login but must be changed, or Invalid if the password is not usable. Specific parameters: Other general parameters are available.
Examples:
|
例
POST リクエスト
Validate a password against the wiki's password policies.
レスポンス
{
"validatepassword": {
"validity": "Good"
}
}
サンプル コード
Python
#!/usr/bin/python3
"""
validatepassword.py
MediaWiki Action API Code Samples
Demo of `Validatepassword` module: Validate a password against the wiki's password policies.
MIT license
"""
import requests
URL = "https://en.wikipedia.org/w/api.php"
S = requests.Session()
PARAMS = {
"action": "validatepassword",
"format": "json",
"password": "",
}
R = S.post(URL, data=PARAMS)
DATA = R.json()
print(DATA)
PHP
<?php
/*
validatepassword.php
MediaWiki Action API Code Samples
Demo of `Validatepassword` module: Validate a password against the wiki's password policies.
MIT license
"""
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$validate_password = validatePassword();
function validatePassword() {
global $endPoint;
$params = [
"action" => "validatepassword",
"password" => "my_password",
"format" => "json"
];
$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, $endPoint );
curl_setopt( $ch, CURLOPT_POST, true );
curl_setopt( $ch, CURLOPT_POSTFIELDS, http_build_query( $params ) );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_COOKIEJAR, "cookie.txt" );
curl_setopt( $ch, CURLOPT_COOKIEFILE, "cookie.txt" );
$output = curl_exec( $ch );
curl_close( $ch );
}
JavaScript
/*
validatepassword.js
MediaWiki Action API Code Samples
Demo of `Validatepassword` module: Validate a password against the wiki's password policies.
MIT license
*/
var request = require("request").defaults({jar: true}),
url = 'https://en.wikipedia.org/w/api.php';
function validatePassword() {
var params = {
action: "validatepassword",
password: "your_password",
format: "json"
};
request.post({ url: url, form: params }, function (error, res, body) {
if (error) {
return;
}
console.log(body);
});
}
MediaWiki JS
/*
validatepassword.js
MediaWiki Action API Code Samples
Demo of `Validatepassword` module: Validate a password against the wiki's password policies.
MIT license
*/
var params = {
action: "validatepassword",
password: "my_password",
format: "json"
},
api = new mw.Api();
api.postWithToken( 'csrf', params ).done( function ( data ) {
console.log( data );
} );
起こりうるエラー
コード | 情報 |
---|---|
userexists | 入力した利用者名は既に使用されています。
別の利用者名を指定してください。 |
nopassword | パラメーター password を設定してください。 |
baduser | Invalid value "username" for user parameter user. |
追加的な注記
- Validity is reported as:
Good
- if the password is acceptableChange
- if the password may be used for login but must be changedInvalid
- if the password is not usable.