Difference between revisions of "MOR API"
From Kolmisoft Wiki
Jump to navigationJump to search
Line 114: | Line 114: | ||
* [[MOR API email send| email_send]] (send_email) – send Email. | * [[MOR API email send| email_send]] (send_email) – send Email. | ||
<br><br> | <br><br> | ||
== | ==Morphone== | ||
* [[MOR_API_morphone_details_get| MOR_API_morphone_details_get]] (MOR_API_morphone_details_get) – API for iphone/android. | * [[MOR_API_morphone_details_get| MOR_API_morphone_details_get]] (MOR_API_morphone_details_get) – API for iphone/android. | ||
<br><br> | <br><br> |
Revision as of 05:47, 13 August 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
- API Configuration – configuration options for API.
- Hash construction – how to construct hash to authenticate data over API.
Login
- user_login (login) – logs user in to MOR.
- user_logout (logout) – logs user out from MOR.
User
- user_register – create new user from params.
- user_details_get (user_details) – gets user details
- user_details_update (user_update_api) – update user from params.
Callback
- callback_init (callback) – initiates 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
- user_balance_get (balance) – retrieves a user balance.
- user_simple_balance_get (simple_balance) – gets user's balance
- user_balance_update (change_user_balance) – change user's balance
Rates
- rate_get (rate) – check user rate by prefix
- tariff_rates_get (get_tariff) – get all tariff's rates
- tariff_retail_import (import_relail_tariff) – import xml retail tariff
- tariff_wholesale_update (wholesale_tariff) – update or create wholesale tariff
Device
- device_create – create device
- device_delete (delete_device) – delete device
- devices_get (device_list) – users device list
- device_callflow_get - returns information about specified device callflow state.
- cli_info_get (cli_get_info) – shows id of device where CLI belongs.
DID
- did_create – DID create
- did_device_assign (did_assign_device) – Assign Device to DID
- did_device_unassign (did_unassign_device) – Unassign Device from DID
Monitorings
- ma_activate – turn on monitorings addon
Phonebooks
- phonebooks_get (phonebooks_api ) – phonebooks list.
- phonebook_edit (phonebook_edit_api) – edit phonebook.
Payments list
- payments_get (payments_list) – payments list.
Credit notes
- credit_notes_get (credit_notes) – credit notes list.
- credit_note_update – credit note update.
- credit_note_create – credit note create.
- credit_note_delete – credit note delete.
Financial statements
- financial_statements_get (financial_statements) – financial statements list.
Payments
- payment_create (create_payment) – create payment.
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.
- card_balance_get (card_balance_get) – show card's balance.
MOR version
- system_version_get (get_version) – get MOR version number.
SMS Send
- sms_send (send_sms) – send SMS.
Send Email
- email_send (send_email) – send Email.
Morphone
- MOR_API_morphone_details_get (MOR_API_morphone_details_get) – API for iphone/android.
Quickforwards
- quickforwards_dids_get (quickforwards_dids_get) – get Quickforwards.
- quickforwards_did_update (quickforwards_did_update) – update Quickforwards.
- quickforwards_did_delete (quickforwards_did_delete) – delete Quickforwards.
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:
- Value of money will be returned in Default System Currency.
- Date will not be affected of Default date format setting.
- Value of money will not be affected of Number digits setting.