MOR API email send

From Kolmisoft Wiki
Revision as of 12:12, 12 January 2014 by Aisteb (talk | contribs) (→‎Parametres)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Description

MOR API Send Email

Usage

  • From MOR X4 call: /api/email_send
  • For Backwards-compatibility old name 'send_email' is also usable. Call: /api/send_email
  • Methods: POST, GET(if allowed, not recomended)



Parametres


NOTE. If in email template there are used some parameters and you do not send them over API, client will get email with empty spaces instead of those parameters. Before sending email over API, be sure that you send all parameters used in email template.

Request

We have email_name = registration_confirmation_for_user, email_to_user_id = 142, login_username = new_first_name, login_url = www.kolmisoft.com, server_ip = 127.0.0.2, API key = 123456

We send:

HTML POST: http://<SERVER_IP>/billing/api/email_send?u=username&email_name=registration_confirmation_for_user&email_to_user_id=142&login_username=new_first_name&login_url=www.kolmisoft.com&server_ip=127.0.0.2&hash=565582398d663e87b5fe3a523f8937fb693bf1e1


NOTE that username are not included in hash

We recive in email:

Your device settings: Server IP: 127.0.0.2 Device type: Username: Password: ---- Settings to login to MOR interface: Login URL: www.kolmisoft.com Username: new_first_name Password: Thank you for registering!

Returns

Success

<?xml version="1.0" encoding="UTF-8"?>
<page>
  <email_sending_status>Email sent</email_sending_status>
</page>




Errors

  • <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
  • <error>Bad login</error>
  • <error>Email not found</error> - Email not found by supplied name in param email_name under logged user account.
  • <error>User not found</error> - User not found by param email_to_user_id.
  • <error>Configuration error. Please consult this help link. (Net::SMTPFatalError - 554 5.7.1 ... </error> - SMTP error. Form more SMTP errors visit : http://wiki.kolmisoft.com/index.php/GUI_Error_-_Email_SMTP
  • <email_sending_status>E-mail has been disabled</email_sending_status> - Turn on email sending in Settings.



See also