Jump to content
MediaWiki

API:Userinfo/ja

From mediawiki.org
This page is a translated version of the page API:Userinfo and the translation is 83% complete.
このページは MediaWiki 操作 API の説明文書の一部です。
MediaWiki 操作 API
基本
認証
利用者とアカウント
ページのオペレーション
検索
開発者向けユーティリティ
チュートリアル
表 · 話 · 編
MediaWiki バージョン:
≧ 1.11

現在のログイン利用者に関する情報を返すGET リクエストです。

APIの説明文書

以下の説明文書は、このサイト (MediaWiki.org) で稼働しているリリース前のバージョンのMediaWikiによって自動的に生成された、Special:ApiHelp/query+userinfo の出力です。

meta=userinfo (ui)

(main | query | userinfo)

Get information about the current user.

Specific parameters:
Other general parameters are available.
uiprop

Which pieces of information to include:

blockinfo
Tags if the current user is blocked, by whom, and for what reason.
hasmsg
Adds a tag messages if the current user has pending messages.
groups
Lists all the groups the current user belongs to.
groupmemberships
Lists groups that the current user has been explicitly assigned to, including the expiry date of each group membership.
implicitgroups
Lists all the groups the current user is automatically a member of.
rights
Lists all the rights the current user has.
changeablegroups
Lists the groups the current user can add to and remove from.
options
Lists all preferences the current user has set.
editcount
Adds the current user's edit count.
ratelimits
Lists all rate limits applying to the current user.
theoreticalratelimits
Lists all rate limits that would apply to the current user if they were not exempt from all ratelimits based on user rights or ip.
email
Adds the user's email address and email authentication date.
realname
Adds the user's real name.
acceptlang
Echoes the Accept-Language header sent by the client in a structured format.
registrationdate
Adds the user's registration date.
unreadcount
Adds the count of unread pages on the user's watchlist (maximum 999; returns 1000+ if more).
watchlistlabels
Adds watchlist labels the user has set up.
centralids
Adds the central IDs and attachment status for the user.
latestcontrib
Adds the date of user's latest contribution.
cancreateaccount
Indicates whether the user is allowed to create accounts. To check whether some specific account can be created, use action=query&list=users&usprop=cancreate.
Values (separate with | or alternative): acceptlang, blockinfo, cancreateaccount, centralids, changeablegroups, editcount, email, groupmemberships, groups, hasmsg, implicitgroups, latestcontrib, options, ratelimits, realname, registrationdate, rights, theoreticalratelimits, unreadcount, watchlistlabels
To specify all values, use *.
uiattachedwiki

With uiprop=centralids, indicate whether the user is attached with the wiki identified by this ID.

Examples:
Get information about the current user.
api.php?action=query&meta=userinfo [open in sandbox]
Get additional information about the current user.
api.php?action=query&meta=userinfo&uiprop=blockinfo|groups|rights|hasmsg [open in sandbox]

例

GET リクエスト

一般的な利用者情報と利用者権限を取得します。

レスポンス

{
"batchcomplete":"",
"query":{
"userinfo":{
"id":37494596,
"name":"Zaycodes",
"groups":[
"*",
"user"
],
"rights":[
"createaccount",
"read",
"edit",
"createtalk",
"writeapi",
"viewmywatchlist",
"editmywatchlist",
"viewmyprivateinfo",
"editmyprivateinfo",
...
]
}
}

サンプル コード

Python

#!/usr/bin/python3
"""
 userinfo.py
 MediaWiki API Demos
 Demo of `Userinfo` module: Get general user info and user rights
 MIT License
"""
importrequests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
PARAMS = {
 "action": "query",
 "meta": "userinfo",
 "uiprop": "rights",
 "format": "json"
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
print(DATA)

PHP

<?php
/*
 userinfo.php
 MediaWiki API Demos
 Demo of `Userinfo` module: Get general user info and user rights
 MIT License
*/
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
 "action" => "query",
 "meta" => "userinfo",
 "uiprop" => "rights",
 "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 );
var_dump( $result );

JavaScript

/*
 userinfo.js
 MediaWiki API Demos
 Demo of `Userinfo` module: Get general user info and user rights
 MIT License
*/
varurl="https://en.wikipedia.org/w/api.php";
varparams={
action:"query",
meta:"userinfo",
uiprop:"rights",
format:"json"
};
url=url+"?origin=*";
Object.keys(params).forEach(function(key){url+="&"+key+"="+params[key];});
fetch(url)
.then(function(response){returnresponse.json();})
.then(function(response){console.log(response);})
.catch(function(error){console.log(error);});

MediaWiki JS

/*
	userinfo.js
	MediaWiki API Demos
	Demo of `Userinfo` module: Get general user info and user rights
	MIT License
*/
varparams={
action:'query',
meta:'userinfo',
uiprop:'rights',
format:'json'
};
varapi=newmw.Api();
api.get(params).then(function(data){
console.log(data);
});

パラメーターの履歴

  • v1.33: latestcontrib を導入しました
  • v1.24: unreadcount を導入しました
  • v1.18: implicitgroups, registrationdate, realname を導入しました
  • v1.17: acceptlang を導入しました
  • v1.16: changeablegroups を導入しました
  • v1.15: email を導入しました
  • v1.14: preferencestoken を導入しました
  • v1.12: ratelimits, editcount を導入しました

追加的な注記

  • The code for the userinfo function is located at ApiQueryUserInfo.php.
  • If you need access to user information not listed here for a user on a Wikimedia project, please email privacy@wikimedia.org for further assistance.

関連項目

AltStyle によって変換されたページ (->オリジナル) /