From mediawiki.org
Jump to navigation Jump to search


メールを送信するにはトークンが必要です。このトークンは編集のためのトークンと同一のもので、送信先に関わらず同じですが、ログインの度に変わります。メールトークンは action=tokens で type=email を指定する(MW 1.20+), または以下の方法で取得できます:

Obtaining an email token


メールアドレスを認証した利用者に action=emailuser でメールを送信することができます。Sending email is subject to rate limits.


  • target: メールの宛先の利用者
  • subject: メッセージの件名
  • text: メッセージ
  • token: 以前のリクエストで取得したトークン。必ず +%2B にエンコードしてください。
  • ccme: 設定すると、メールのコピーをあなたにお送りします


注記: 簡潔性のためにこの例ではすべてのパラメーターをGETリクエストで渡していますが, action=emailuser はPOSTリクエストを必要とします; GETリクエストだとエラーが発生します。

Sending an email to User:Catrope


In addition to the usual stuff:

Code Info
cantsend You are not logged in, you do not have a confirmed email address, or you are not allowed to send email to other users, so you cannot send email.
blockedfrommail You have been blocked from sending email.
usermaildisabled User email has been disabled
notarget You have not specified a valid target for this action.
noemail この利用者は有効なメールアドレスを登録していません。

Checking emailable status[edit]

Before trying to send an email, it is recommended to check if the user is emailable first. To do this, you can execute a list query on the user (or several users at once). Here is an example using Ajax:

new mw.Api().get( {
  action: 'query',
  list: 'users',
  ususers: mw.config.get( 'wgTitle' ),
  usprop: 'emailable',
  rawcontinue: ''
} ).done( function( getEmailable ) {
  alert( ( getEmailable.query.users[ 0 ][ 'emailable' ] !== undefined ) ? 'emailable' : 'not emailable' );
} );

If you are testing from a client-side script, it is also possible to simply check for the existence of the t-emailuser list item:

emailable = $( '#t-emailuser' ).length ? true : false;


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

Email a user.


User to send the email to.

This parameter is required.

Subject header.


Email body.

This parameter is required.

Send a copy of this mail to me.

Type: boolean (details)

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

This parameter is required.
Send an email to the user WikiSysop with the text Content.
api.php?action=emailuser&target=WikiSysop&text=Content&token=123ABC [open in sandbox]