Difference between revisions of "MOR API sms send"

From Kolmisoft Wiki
Jump to navigationJump to search
m
Line 1: Line 1:
= About =
= Description =
SMS API is used to integrate MOR with other external systems like CRM, ERP or other for SMS sending through them.
SMS API is used to integrate MOR with other external systems like CRM, ERP or other for SMS sending through them.


Users which can user SMS API:
Users which can user SMS API:
* admin
* Admin
* reseller - starting from MOR 12
<!---This functionality is available from MOR 12--->
* Reseller
<br><br>
= Usage =


* Call: /api/sms_send
* Methods: POST, GET(if allowed, not recomended)
<br><br>
===Parametres===


== Send SMS ==
* lcr_id - LCR ID in MOR database. '''Required'''.
* u - username to login. '''Required'''.
* dst - Destination number. '''Required'''.
* src - Source number. '''Required'''.
* message - Message that you want to send. '''Required'''.
* [[MOR API hash construction | hash]] - SHA1 hash constructed using '''API_Secret_Key''' ([[MOR API hash construction | More described in Constructing hash]]). '''Required'''.


* 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'''.
** [[MOR API hash construction | hash]] - SHA1 hash constructed using '''API_Secret_Key''' ([[MOR API hash construction | More described in Constructing hash]]). '''Required'''.
'''* Note that message must be in [http://meta.wikimedia.org/wiki/Help:URL URL Encode]'''
'''* Note that message must be in [http://meta.wikimedia.org/wiki/Help:URL URL Encode]'''
<br><br>
===Request===
We have lcr_id = 1, dst = 937567337911, src = 9375783123767, message = hi, API key = 123456
**We send:
HTML POST: http://<server_ip>/api/send_sms?u=username&lcr_id=1&dst=937567337911&src=9375783123767&message=hi&hash=cc0e27123e27f08de2fbc68a2c8ba0b213654687


'''* Note that username and password are not included in hash'''
<br><br>
===Returns===
===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 ===
'''Success'''
*** <error>There is no message or it is empty</error>
<page>
*** <error>Wrong source</error>
  <response>
*** <error>Wrong destination</error>
    <status>ok</status>
*** <error>There is no such LCR</error>
    <message>
*** <error>User is not subscribed to sms service</error>
      <message_id> message id </message_id>
*** <error>1 - failed, admin does not have rate for this destination</error> - SMS status code and tip [[SMS Addon - Status codes]]
      <sms_status_code_tip>SMS is sent</sms_status_code_tip>
*** <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
      <price> price </price>
*** <error>Bad login</error>  
      <currency> currency </currency>
    </message>
  </response>
</page>
<br><br>
<br><br>
----


===Example===
'''Errors'''
**We have lcr_id = 1, dst = 937567337911, src = 9375783123767, message = 1a2b3c4d, API key = 123456
**We send:
***/api/send_sms?u=username&p=password&lcr_id=1&dst=937567337911&src=9375783123767&message=1a2b3c4d&hash=cc0e27123e27f08de2fbc68a2c8ba0b213654687
'''* Note that username and password are not included in hash'''


* <error>There is no message or it is empty</error> – message text not found.
* <error>Wrong source</error> – source number is wrong.
* <error>Wrong destination</error> – destination number is wrong.
* <error>There is no such LCR</error> – LCR id not found.
* <error>User is not subscribed to sms service</error>  – user is not [[SMS_Addon#Configuration | Subscribed]] for sms usage.
* <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.
<br><br>
= See also =


=== See also ===
* [[MOR API]]
* [[MOR API]]
<br><br>
<br><br>

Revision as of 12:55, 23 May 2013

Description

SMS API is used to integrate MOR with other external systems like CRM, ERP or other for SMS sending through them.

Users which can user SMS API:

  • Admin
  • Reseller



Usage

  • Call: /api/sms_send
  • Methods: POST, GET(if allowed, not recomended)



Parametres

  • lcr_id - LCR ID in MOR database. Required.
  • u - username to login. Required.
  • dst - Destination number. Required.
  • src - Source number. Required.
  • message - Message that you want to send. Required.
  • hash - SHA1 hash constructed using API_Secret_Key ( More described in Constructing hash). Required.

* Note that message must be in URL Encode

Request

We have lcr_id = 1, dst = 937567337911, src = 9375783123767, message = hi, API key = 123456

    • We send:
HTML POST: http://<server_ip>/api/send_sms?u=username&lcr_id=1&dst=937567337911&src=9375783123767&message=hi&hash=cc0e27123e27f08de2fbc68a2c8ba0b213654687

* Note that username and password are not included in hash

Returns

Success

<page>
  <response>
    <status>ok</status>
    <message>
      <message_id> message id </message_id>
      <sms_status_code_tip>SMS is sent</sms_status_code_tip>
      <price> price </price>
      <currency> currency </currency>
   </message>
  </response>
</page>




Errors

  • <error>There is no message or it is empty</error> – message text not found.
  • <error>Wrong source</error> – source number is wrong.
  • <error>Wrong destination</error> – destination number is wrong.
  • <error>There is no such LCR</error> – LCR id not found.
  • <error>User is not subscribed to sms service</error> – user is not Subscribed for sms usage.
  • <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.



See also