Difference between revisions of "MOR API"
From Kolmisoft Wiki
Jump to navigationJump to search
(→Device) |
|||
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]] | * [[API Configuration]] – configuration options for API. | ||
* [[MOR API hash construction|Hash construction]] | * [[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]] | * [[MOR API user_login|user_login]] (login) – logs user in to MOR. | ||
* [[MOR API user_logout|user_logout]] | * [[MOR API user_logout|user_logout]] (logout) – logs user out from MOR. | ||
<br><br> | |||
==User== | ==User== | ||
* [[MOR API user_register| user_register]] | * [[MOR API user_register| user_register]] – create new user from params. | ||
* [[MOR API user_details_get | user_details_get]] | * [[MOR API user_details_get | user_details_get]] (user_details) – gets user details | ||
* [[MOR_API_user_details_update| user_details_update]] | * [[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]] | * [[MOR API callback init|callback_init]] (callback) – initiates callback. | ||
<br><br> | |||
==Accounting== | ==Accounting== | ||
* [[MOR API invoices_get|invoices_get]] | * [[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]] | * [[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]] | * [[MOR API user_balance_get|user_balance_get]] (balance) – retrieves a user balance. | ||
* [[Balance in phone | user_simple_balance_get]] | * [[Balance in phone | user_simple_balance_get]] (simple_balance) – gets user's balance | ||
* [[MOR API user balance update | user_balance_update]] | * [[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]] | * [[MOR API rate get|rate_get]] (rate) – check user rate by prefix | ||
* [[MOR API tariff rates get| tariff_rates_get]] | * [[MOR API tariff rates get| tariff_rates_get]] (get_tariff) – get all tariff's rates | ||
* [[MOR API tariff_retail_import | tariff_retail_import ]] | * [[MOR API tariff_retail_import | tariff_retail_import ]] (import_relail_tariff) – import xml retail tariff | ||
* [[MOR API tariff_wholesale_update | tariff_wholesale_update ]] | * [[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]] | * [[MOR API did_create| did_create]] – DID create | ||
* [[MOR_API_did_device_assign| did_device_assign]] | * [[MOR_API_did_device_assign| did_device_assign]] (did_assign_device) – Assign Device to DID | ||
* [[MOR_API_did_device_unassign| did_device_unassign]] | * [[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]] | * [[MOR API ma_activate_api| ma_activate]] – turn on monitorings addon | ||
<br><br> | |||
==Phonebooks== | ==Phonebooks== | ||
* [[MOR API phonebooks_get| phonebooks_get]] | * [[MOR API phonebooks_get| phonebooks_get]] (phonebooks_api ) – phonebooks list. | ||
* [[MOR API phonebook_edit| phonebook_edit]] | * [[MOR API phonebook_edit| phonebook_edit]] (phonebook_edit_api) – edit phonebook. | ||
<br><br> | |||
==Payments list== | ==Payments list== | ||
* [[MOR API payments_get| payments_get]] | * [[MOR API payments_get| payments_get]] (payments_list) – payments list. | ||
<br><br> | |||
==Credit notes== | ==Credit notes== | ||
* [[MOR API credit_notes_get| credit_notes_get]] | * [[MOR API credit_notes_get| credit_notes_get]] (credit_notes) – credit notes list. | ||
* [[MOR API 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]] | * [[MOR API credit_notes_create| credit_note_create]] – credit note create. | ||
* [[MOR API credit_notes_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]] | * [[MOR API financial_statements_get| financial_statements_get]] (financial_statements) – financial statements list. | ||
<br><br> | |||
==Payments== | ==Payments== | ||
* [[MOR API payment_create| payment_create]] | * [[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]] | * [[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]] | * [[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]] | * [[MOR API card_group_get| card_group_get]] (show_calling_card_group) – show calling group info. | ||
<br><br> | |||
==MOR version== | ==MOR version== | ||
* [[MOR API | * [[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]] | * [[MOR API sms send| sms_send]] (send_sms) – send SMS. | ||
<br><br> | |||
==Send Email== | ==Send Email== | ||
* [[MOR API email send| email_send]] | * [[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> | |||
=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
- 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
- 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.
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.
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.