API:Block/ja

トークン
利用者をブロック/ブロック解除するために、ブロック/ブロック解除トークンが必要です. このトークンは編集トークンと同様すべてのブロックに対して共通ですが、ログインのたびに変化します. ブロック/ブロック解除トークンは、action=tokens の type に (un)block を指定することで取得できます (MW 1.20 以降). または、以下の方法で取得できます:

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

パラメーター

 * : ブロックしたい利用者名、IPアドレスまたはIPの範囲.
 * : 以前のリクエストで取得されたトークン. '+'を'%2B'にurlencodeすることに注意して下さい
 * : 相対的な期限時間、例えば、'5 months'や'2 weeks'などです. years、daysとhoursも受け入れされます. 'infinite'、'infinity'、 'never'、または全く設定しない場合、ブロックが期限切れしなくなります.
 * : ブロックする理由(オプション).
 * : 設定されると、利用者のIPからの匿名ログインのみがブロックされるので、編集できるようにするために利用者にログインまたはアカウントを作ることを強制できます.
 * : 設定されると、利用者のIPからアカウント作成をブロックします
 * : 設定されると、この利用者によって使われた最後のIPアドレスとログインしようとする次のIPを自動的にブロックします.
 * : 設定されると、利用者がSpecial:Emailuserでのメール送信ができなくなります.
 * : Hide the username from the block log. (Requires the "hideuser" right.)
 * : Allow the user to edit their own talk page (depends on $wgBlockAllowsUTEdit)
 * : If the user is already blocked, overwrite the existing block
 * : Watch the user/IP's user and talk pages

Don't forget to append = even to parameters with no value, for example &autoblock doesn't work, &autoblock= does work

例
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で利用者のブロックを解除できます.

パラメーター

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

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


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