API:Block/ja

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

利用者のブロック
利用者を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., , not just  ).

パラメーター

 * : ブロックしたい利用者名、IPアドレスまたはIPの範囲.
 * : 以前のリクエストで取得されたトークン. '+'を'%2B'にurlencodeすることに注意して下さい
 * : 相対的な期限時間、例えば、'5 months'や'2 weeks'などです. years、daysとhoursも受け入れされます. 'infinite'、'infinity'、 'never'、または全く設定しない場合、ブロックが期限切れしなくなります.
 * : ブロックする理由(オプション).
 * : 設定されると、利用者のIPからの匿名ログインのみがブロックされるので、編集できるようにするために利用者にログインまたはアカウントを作ることを強制できます.
 * : 設定されると、利用者のIPからアカウント作成をブロックします
 * : 設定されると、この利用者によって使われた最後のIPアドレスとログインしようとする次のIPを自動的にブロックします.
 * : 設定されると、利用者がSpecial:Emailuserでのメール送信ができなくなります.

例
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.

起こり得るエラー
通常のものに加えて次のものがあります:

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

パラメーター
Only one of id, user , or userid must be specified.
 * : undoしたいブロックのID. ブロックIDはlist=ipblocksを通して入手できます.
 * : ブロックを解除したい利用者名、IPアドレスまたはIPの範囲.
 * : 以前のリクエストで取得されたトークン. '+'を'%2B'にurlencodeすることに注意して下さい.
 * : ブロック解除の理由(オプション).
 * : 設定すると、トークンが返されるようになります. 以前のリクエストも参照して下さい.
 * : 設定すると、トークンが返されるようになります. 以前のリクエストも参照して下さい.
 * : 設定すると、トークンが返されるようになります. 以前のリクエストも参照して下さい.

起こり得るエラー
通常のものに加えて以下のものがあります: