MOR API sms send

From Kolmisoft Wiki
Revision as of 13:13, 13 June 2012 by Admin (talk | contribs)
Jump to navigationJump to search

Link titleThis functionality is available from MOR 12


MOR API

Send SMS






  • Call: /api/send_sms
  • Params:
    • lcr_id - LCR ID in MOR database. Required.
    • u - username to login. Required.
    • p - password to login. Required.
    • dst - Destination number. Required.
    • src - Source number. Required.
    • message - Message that you want to send. Required.
    • hash - SHA1 hash constructed using device and API_Secret_Key ( More described in Constructing hash). Required.

* Note that message must be in URL Encode

  • Returns:
    • Success
 <status>ok</status>
 <message>
    <message_id>1</message_id>
    <sms_status_code_tip>0 - sent, SMS is sent</sms_status_code_tip>
    <price>0.5000</price>
    <currency>USD</currency>
 </message>
    • Errors:
      • <error>There is no message or it is empty</error>
      • <error>Wrong source</error>
      • <error>Wrong destination</error>
      • <error>There is no such LCR</error>
      • <error>User is not subscribed to sms service</error>
      • <error>1 - failed, admin does not have rate for this destination</error> - SMS status code and tip SMS Addon - Status codes
      • <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
      • <error>Bad login</error>




  • Example:
    • We have lcr_id = 1, dst = 937567337911, src = 9375783123767, message = labas, API key = 123456
    • We send:
      • /api/send_sms?u=username&p=password&lcr_id=1&dst=937567337911&src=9375783123767&message=labas&hash=19d0b40223fa7e68415d484a9d7d8819cd21a0be

* Note that username and password are not included in hash