MOR API card from group sell

From Kolmisoft Wiki
Revision as of 08:34, 23 January 2013 by Aisteb (talk | contribs)
Jump to navigationJump to search

MOR API sells Cards from Calling Card Group




  • Call: /api/buy_card_from_callingroup
  • Methods: POST, GET(if allowed, not recomended)
  • Params:
    • id - Calling Card Group ID in MOR database. Required.
    • quantity - default 1. Optional.
    • u - username to login. Required.
    • p - password to login. Required.
    • email - email address, to send information about bought card Optional.
    • hash - SHA1 hash constructed using id and quantity and API_Secret_Key ( More described in Constructing hash). Required.
  • Returns:
    • Success

<cards>

 <card>
   <pin>...</pin>
   <number>..</number>
   <balance_without_vat>...</balance_without_vat>
   <currency>...</currency>
 </card>
 <card>
   <pin>...</pin>
   <number>...</number>
   <balance_without_vat>...</balance_without_vat>
   <currency>...</currency>
 </card>

</cards>


    • Errors:
      • <error>Bad login</error> - User supplied bad login or password.
      • <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
      • <error>Cardgroup was not found</error> - Use correct Calling Card Group ID .
      • <error>Free cards was not found/error> - no free cards in Calling Card Group.




  • Example:
    • We have id = 6, quantity = 2, API Secret Key = 456789
    • Hash string to be converted: "62456789"
    • We might send:
      • /api/buy_card_from_callingroup?id=6&quantity=2&hash=37086d860581fabc278413cd1a417d5c079f6eba&u=admin&p=admin

* Note that username and password are not included in hash