API:Block/ja

From MediaWiki.org
Jump to navigation Jump to search
言語: English  • Deutsch • 日本語

トークン[edit]

利用者をブロック/ブロック解除するために、ブロック/ブロック解除トークンが必要です。このトークンは編集トークンと同様すべてのブロックに対して共通ですが、ログインのたびに変化します。For MediaWiki 1.24 onwards, the needed token can be obtained via meta=tokens with the type set to csrf. For MediaWiki 1.20–1.23, see API:Tokens (action); for older versions, see API:Info or use the now-removed gettoken parameter.

blockトークンを取得する

利用者のブロック[edit]

利用者をaction=blockでブロックできます。This must be sent as a POST request. As such, don't forget to append an = to parameters with no value (e.g., autoblock=, not just autoblock).

パラメーター[edit]

  • user: ブロックしたい利用者名、IPアドレスまたはIPの範囲。
  • token: 以前のリクエストで取得されたトークン。'+'を'%2B'にurlencodeすることに注意して下さい
  • expiry: 相対的な期限時間、例えば、'5 months'や'2 weeks'などです。years、daysとhoursも受け入れされます。'infinite'、'infinity'、 'never'、または全く設定しない場合、ブロックが期限切れしなくなります。
  • reason: ブロックする理由(オプション)。
  • anononly: 設定されると、利用者のIPからの匿名ログインのみがブロックされるので、編集できるようにするために利用者にログインまたはアカウントを作ることを強制できます。
  • nocreate: 設定されると、利用者のIPからアカウント作成をブロックします
  • autoblock: 設定されると、この利用者によって使われた最後のIPアドレスとログインしようとする次のIPを自動的にブロックします。
  • noemail: 設定されると、利用者がSpecial:Emailuserでのメール送信ができなくなります。
  • hidename: Hide the username from the block log. (Requires the "hideuser" right.)
  • allowusertalk: Allow the user to edit their own talk page (depends on $wgBlockAllowsUTEdit) 1.14+
  • reblock: If the user is already blocked, overwrite the existing block 1.14+
  • watchuser: Watch the user/IP's user and talk pages 1.18+
  • gettoken: If set, a block token will be returned, and no other action will be taken (1.20 以降廃止予定) (1.21 で除去済)
  • tags: Tags to apply to the entry in the block log. 1.29+

[edit]

Note: In this example, all parameters are passed in a GET request just for the sake of simplicity. However, action=block requires POST requests; GET requests will cause an error. Blocking Example for 1 day, disabling account creation and email

起こり得るエラー[edit]

通常のものに加えて次のものがあります:

コード 情報
nouser userパラメーターを設定しなければなりません
notoken tokenパラメーターを設定しなければなりません
permissiondenied 利用者をブロックする権限がありません
注: 大抵のwikiでは、利用者をブロックする権限はsysopに制限されますが、別のwikiの中にはより厳しいルールを課しているものもあります。
invalidrange 無効なIPの範囲
rangedisabled IP範囲のブロックが無効にされています
invalidip 無効なIPアドレスが指定された
invalidexpiry 無効な期限切れの時間
alreadyblocked ブロックしようとした利用者は既にブロックされています
pastexpiry 期限の時間は過ぎました
cantblock 利用者をブロックする権限がありません
canthide ブロック記録から利用者名を隠す権限がありません
注: この機能はLocalSettings.phpで明示的に有効にしなければなりません。
cantblock-email 利用者がwikiを通してメールを送ることをブロックする権限がありません




action=block

(main | block)
  • This module requires read rights.
  • This module requires write rights.
  • This module only accepts POST requests.
  • Source: MediaWiki
  • License: GPL-2.0-or-later

Block a user.

Parameters:
user

Username, IP address, or IP address range to block. Cannot be used together with userid

Type: user name
userid

User ID to block. Cannot be used together with user.

Type: integer
expiry

Expiry time. May be relative (e.g. 5 months or 2 weeks) or absolute (e.g. 2014-09-18T12:34:56Z). If set to infinite, indefinite, or never, the block will never expire.

Default: never
reason

Reason for block.

Default: (empty)
anononly

Block anonymous users only (i.e. disable anonymous edits for this IP address).

Type: boolean (details)
nocreate

Prevent account creation.

Type: boolean (details)
autoblock

Automatically block the last used IP address, and any subsequent IP addresses they try to login from.

Type: boolean (details)
noemail

Prevent user from sending email through the wiki. (Requires the blockemail right).

Type: boolean (details)
hidename

Hide the username from the block log. (Requires the hideuser right).

Type: boolean (details)
allowusertalk

Allow the user to edit their own talk page (depends on $wgBlockAllowsUTEdit).

Type: boolean (details)
reblock

If the user is already blocked, overwrite the existing block.

Type: boolean (details)
watchuser

Watch the user's or IP address's user and talk pages.

Type: boolean (details)
tags

Change tags to apply to the entry in the block log.

Values (separate with | or alternative):
token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.
Examples:
Block IP address 192.0.2.5 for three days with reason First strike.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [open in sandbox]
Block user Vandal indefinitely with reason Vandalism, and prevent new account creation and email sending.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [open in sandbox]

利用者のブロック解除[edit]

action=unblockで利用者のブロックを解除できます。

パラメーター[edit]

Only one of id, user, or userid must be specified.

  • id: undoしたいブロックのID。ブロックIDはlist=ipblocksを通して入手できます。
  • user: ブロックを解除したい利用者名、IPアドレスまたはIPの範囲。
  • userid: User ID to unblock. Cannot be used together with id or user. 1.29+
  • token: 以前のリクエストで取得されたトークン。'+'を'%2B'にurlencodeすることに注意して下さい。
  • reason: ブロック解除の理由(オプション)。
  • tags: Change tags to apply to the entry in the block log. 1.27+
  • gettoken: 設定すると、トークンが返されるようになります。以前のリクエストも参照して下さい。

サンプルのリクエスト[edit]

Unblocking Example and apologizing

起こり得るエラー[edit]

通常のものに加えて以下のものがあります:

Code Info
notarget idまたはuserパラメーターを設定しなければなりません
notoken tokenパラメーターを設定しなければなりません
idanduser idとuserパラメーターは一緒に使うことはできません
blockedasrange `range''の一部としてIPアドレス``address''はブロックされました。IPを個別にブロック解除できませんが、全体として範囲をブロック解除できます。
cantunblock 指定したブロックが存在しませんでした。既にブロック解除されているのかもしれません
permissiondenied 利用者をブロック解除する権限がありません。 Note: 大抵のwikiでは、利用者のブロック解除の権限はsysopに制限されますが、別のwikiの中にはより厳しいルールを課しているものがあります。




action=unblock

(main | unblock)
  • This module requires read rights.
  • This module requires write rights.
  • This module only accepts POST requests.
  • Source: MediaWiki
  • License: GPL-2.0-or-later

Unblock a user.

Parameters:
id

ID of the block to unblock (obtained through list=blocks). Cannot be used together with user or userid.

Type: integer
user

Username, IP address or IP address range to unblock. Cannot be used together with id or userid.

userid

User ID to unblock. Cannot be used together with id or user.

Type: integer
reason

Reason for unblock.

Default: (empty)
tags

Change tags to apply to the entry in the block log.

Values (separate with | or alternative):
token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.