Difference between revisions of "MOR API"

From Kolmisoft Wiki
Jump to navigationJump to search
Line 3: Line 3:


MOR accepts requests by HTML POST and returns results in XML.
MOR accepts requests by HTML POST and returns results in XML.
 
<br><br>
 
=MOR users that are allowed to use MOR API=
=MOR users that are allowed to use MOR API=
* Admin
* Admin
Line 12: Line 11:
* Accountant - only by using Admin Hash and Secret key
* Accountant - only by using Admin Hash and Secret key
<br><br>
<br><br>
=Functions=
=Functions=


== API Related ==
== API Related ==


* [[API Configuration]] - configuration options for API.
* [[API Configuration]] configuration options for API.
* [[MOR API hash construction|Hash construction]] - how to construct hash to authenticate data over API.
* [[MOR API hash construction|Hash construction]] how to construct hash to authenticate data over API.
 
<br><br>
==Login==
==Login==


* [[MOR API user_login|user_login]] - logs user in to MOR.
* [[MOR API user_login|user_login]] (login) – logs user in to MOR.
* [[MOR API user_logout|user_logout]] - logs user out from MOR.
* [[MOR API user_logout|user_logout]] (logout) – logs user out from MOR.
 
<br><br>
==User==
==User==


* [[MOR API user_register| user_register]] - create new user from params.
* [[MOR API user_register| user_register]] create new user from params.
* [[MOR API user_details_get | user_details_get]] - gets user details
* [[MOR API user_details_get | user_details_get]] (user_details) – gets user details
* [[MOR_API_user_details_update| user_details_update]] - update user from params.
* [[MOR_API_user_details_update| user_details_update]] (user_update_api) – update user from params.
 
<br><br>
==Callback==
==Callback==


* [[MOR API callback init|callback_init]] - initiates callback.
* [[MOR API callback init|callback_init]] (callback) – initiates callback.
 
<br><br>
==Accounting==
==Accounting==


* [[MOR API invoices_get|invoices_get]] - retrieves a list of invoices in a selected time period.
* [[MOR API invoices_get|invoices_get]] (invoices) – retrieves a list of invoices in a selected time period.
 
<br><br>
==Calls==
==Calls==


* [[MOR API user calls get|user_calls_get]] - retrieves a list of calls in a selected time period for a user/device.
* [[MOR API user calls get|user_calls_get]] (user_calls) – retrieves a list of calls in a selected time period for a user/device.
 
<br><br>
==Balance==
==Balance==


* [[MOR API user_balance_get|user_balance_get]] - retrieves a user balance.
* [[MOR API user_balance_get|user_balance_get]] (balance) – retrieves a user balance.
* [[Balance in phone | user_simple_balance_get]] - gets user's balance
* [[Balance in phone | user_simple_balance_get]] (simple_balance) – gets user's balance
* [[MOR API user balance update | user_balance_update]] - change user's balance
* [[MOR API user balance update | user_balance_update]] (change_user_balance) – change user's balance
 
<br><br>
==Rates==
==Rates==


* [[MOR API rate get|rate_get]] - check user rate by prefix
* [[MOR API rate get|rate_get]] (rate) – check user rate by prefix
* [[MOR API tariff rates get| tariff_rates_get]] - get all tariff's rates
* [[MOR API tariff rates get| tariff_rates_get]] (get_tariff) – get all tariff's rates
* [[MOR API tariff_retail_import | tariff_retail_import ]] - import xml retail tariff
* [[MOR API tariff_retail_import | tariff_retail_import ]] (import_relail_tariff) – import xml retail tariff
* [[MOR API tariff_wholesale_update | tariff_wholesale_update ]] - update or create wholesale tariff
* [[MOR API tariff_wholesale_update | tariff_wholesale_update ]] (wholesale_tariff) – update or create wholesale tariff
 
<br><br>
==Device==
==Device==


* [[MOR API device create| device_create]] – create device
* [[MOR API device create| device_create]] – create device
* [[MOR API device delete| device_delete]] – delete device
* [[MOR API device delete| device_delete]] (delete_device) – delete device
* [[MOR API devices get | devices_get]] – users device list
* [[MOR API devices get | devices_get]] (device_list) – users device list
* [[MOR API CLI info get | cli_info_get]] – shows id of device where CLI belongs.
* [[MOR API CLI info get | cli_info_get]] (cli_get_info) – shows id of device where CLI belongs.
 
<br><br>
==DID==
==DID==


* [[MOR API did_create| did_create]] - DID create
* [[MOR API did_create| did_create]] DID create
* [[MOR_API_did_device_assign| did_device_assign]] - Assign Device to DID
* [[MOR_API_did_device_assign| did_device_assign]] (did_assign_device) – Assign Device to DID
* [[MOR_API_did_device_unassign| did_device_unassign]] - Unassign Device from DID
* [[MOR_API_did_device_unassign| did_device_unassign]] (did_unassign_device) – Unassign Device from DID
 
<br><br>
==Monitorings==
==Monitorings==


* [[MOR API ma_activate_api| ma_activate]] - turn on monitorings addon
* [[MOR API ma_activate_api| ma_activate]] turn on monitorings addon
 
<br><br>
==Phonebooks==
==Phonebooks==


* [[MOR API phonebooks_get| phonebooks_get]] - phonebooks list.
* [[MOR API phonebooks_get| phonebooks_get]] (phonebooks_api ) – phonebooks list.
* [[MOR API phonebook_edit| phonebook_edit]] - edit phonebook.
* [[MOR API phonebook_edit| phonebook_edit]] (phonebook_edit_api) – edit phonebook.
 
<br><br>
==Payments list==
==Payments list==


* [[MOR API payments_get| payments_get]] - payments list.
* [[MOR API payments_get| payments_get]] (payments_list) – payments list.
 
<br><br>
==Credit notes==
==Credit notes==


* [[MOR API credit_notes_get| credit_notes_get]] - credit notes list.
* [[MOR API credit_notes_get| credit_notes_get]] (credit_notes) – credit notes list.
* [[MOR API credit_note_update| credit_note_update]] - credit note update.
* [[MOR API credit_note_update| credit_note_update]] credit note update.
* [[MOR API credit_notes_create| credit_note_create]] - credit note create.
* [[MOR API credit_notes_create| credit_note_create]] credit note create.
* [[MOR API credit_notes_delete| credit_note_delete]] - credit note delete.
* [[MOR API credit_notes_delete| credit_note_delete]] credit note delete.
 
<br><br>
==Financial statements==
==Financial statements==


* [[MOR API financial_statements_get| financial_statements_get]] - financial statements list.
* [[MOR API financial_statements_get| financial_statements_get]] (financial_statements) – financial statements list.
 
<br><br>
==Payments==
==Payments==


* [[MOR API payment_create| payment_create]] - create payment.
* [[MOR API payment_create| payment_create]] (create_payment) – create payment.
 
<br><br>
==Calling cards==
==Calling cards==


* [[MOR API card_by_cli_update| card_by_cli_update]] - creates and updates calling cards, including adding and transferring funds, by being identified according the Caller_ID.
* [[MOR API card_by_cli_update| card_by_cli_update]] (cc_by_cli) – creates and updates calling cards, including adding and transferring funds, by being identified according the Caller_ID.
* [[MOR API card_from_group_sell| card_from_group_sell]] - sells cards from calling card group.
* [[MOR API card_from_group_sell| card_from_group_sell]] (buy_card_from_callingroup) – sells cards from calling card group.
* [[MOR API card_group_get| card_group_get]] - show calling group info.
* [[MOR API card_group_get| card_group_get]] (show_calling_card_group) – show calling group info.
 
<br><br>
==MOR version==
==MOR version==
* [[MOR API get_version| get_version]] - get MOR version number.
* [[MOR API system version get| system_version_get]] (get_version) – get MOR version number.
 
<br><br>
==SMS Send==
==SMS Send==
* [[MOR API sms send| sms_send]] - send SMS.
* [[MOR API sms send| sms_send]] (send_sms) – send SMS.
 
<br><br>
==Send Email==
==Send Email==
* [[MOR API email send| email_send]] - send Email.
* [[MOR API email send| email_send]] (send_email) – send Email.
 
<br><br>
<br>
 
= Examples =
= Examples =
* [[MOR API PHP Examples]]
* [[MOR API PHP Examples]]
 
<br><br>
<br><br><br><br>
 
=HTML POST=
=HTML POST=


Line 129: Line 123:
If the user has 'admin' rights, he will get more results and  can perform more actions compared to a user who does not have such rights.
If the user has 'admin' rights, he will get more results and  can perform more actions compared to a user who does not have such rights.
<br><br>
<br><br>
=Useful to know=


* All API methods returns data straight from database. It means that MOR GUI settings does not affect data, it will be returned as it is saved in database. For example:
** Value of money will be returned in Default System [[Currencies|Currency]].
** Date will not be affected of [[Configuration_from_GUI#Visual| Default date format]] setting.
** Value of money will not be affected of [[Configuration_from_GUI#Visual|Number digits]] setting.
<br><br>
=See also =
=See also =
* [[API Configuration]]
* [[API Configuration]]
* [[MOR integration]]
* [[MOR integration]]
* [[How to block access to some API functions]]
* [[How to block access to some API functions]]

Revision as of 14:13, 31 July 2013

About

MOR API lets other software interact with MOR without knowing the internal structure of the database (DB) and other logic.

MOR accepts requests by HTML POST and returns results in XML.

MOR users that are allowed to use MOR API

  • Admin
  • Reseller
  • Accountant - only by using Admin Hash and Secret key



Functions

API Related



Login



User



Callback



Accounting

  • invoices_get (invoices) – retrieves a list of invoices in a selected time period.



Calls

  • user_calls_get (user_calls) – retrieves a list of calls in a selected time period for a user/device.



Balance



Rates



Device



DID



Monitorings



Phonebooks



Payments list



Credit notes



Financial statements



Payments



Calling cards

  • card_by_cli_update (cc_by_cli) – creates and updates calling cards, including adding and transferring funds, by being identified according the Caller_ID.
  • card_from_group_sell (buy_card_from_callingroup) – sells cards from calling card group.
  • card_group_get (show_calling_card_group) – show calling group info.



MOR version



SMS Send



Send Email



Examples



HTML POST

All requests are in a similar format:

HTML POST: http://<SERVER_IP>/billing/api/<function>?u=username
  • username - the user name and password of the user who is asking for the data.

If the user has 'admin' rights, he will get more results and can perform more actions compared to a user who does not have such rights.

Useful to know

  • All API methods returns data straight from database. It means that MOR GUI settings does not affect data, it will be returned as it is saved in database. For example:



See also