API:Emailuser/ja

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

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

パラメーター

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

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

起こりうるエラー
In addition to the usual stuff:


 * code: cantsend
 * info: You're not logged in or you don't have a confirmed email address, so you can't send email
 * code: blockedfrommail
 * info: You have been blocked from sending email
 * code: usermaildisabled
 * info: User email has been disabled
 * code: notarget
 * info: You have not specified a valid target for this action
 * code: noemail
 * info: The user has not specified a valid email address, or has chosen not to receive email from other users

Checking emailable status
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:

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: