Difference between revisions of "MOR API provider create"
From Kolmisoft Wiki
Jump to navigationJump to search
(Created page with "=Description= MOR API for creating providers. <br><br> =Usage= * From '''MOR X17''' call: '''/api/provider_create''' * Methods: POST, GET(if allowed, not recomended) <br><br> ===Parametres=== * u - username to login. '''Required'''. * hash – SHA1 hash constructed using '''API Secret Key''' ( More described in Constructing hash). '''Required'''. * name - Provider's name, must be unique '''Required'''....") |
|||
Line 17: | Line 17: | ||
* tariff_id - Tariff to use, can be any Provider Tariff (tariffs.purpose == 'provider') '''Required'''. | * tariff_id - Tariff to use, can be any Provider Tariff (tariffs.purpose == 'provider') '''Required'''. | ||
* server_ids - Asterisk Servers, must be in following format "1,3,4", if this parameter is not used, all Asterisk Servers are automatically assigned | * server_ids - Asterisk Servers, must be in following format "1,3,4", if this parameter is not used, all Asterisk Servers are automatically assigned | ||
* active - 1 for active, 0 for not active | |||
* dtmfmode - DTMF Mode, accepted values [inband, info, rfc2833, auto]. If CCL is active and Provider is SIP, then accepted values are [rfc2833, auto] | |||
* location_id - Any Location (locations) by owner (locations.user_id) | |||
* timeout - Ringing Timeout, any integer value which is equal to 30 or higher | |||
* max_timeout - Call Timeout, any integer value which is equal to 0 or higher | |||
* call_limit - Call Limit, any integer value which is equal to 0 or higher | |||
* balance_limit - Balance limit, any decimal value (value separated by dot ".") | |||
* login - Authentication Login/Username ("anonymous" and "unknown" are not allowed) | |||
* password - Authentication Password | |||
* register - Authentication Register, 0 - Not register, 1 - Register. If Network related type is Dynamic, Register is automatically set to 0 | |||
* cid_name - Provider CallerID Name | |||
* cid_number - Provider CallerID Number | |||
* network_type - Network related type, accepted values [hostname ip dynamic] | |||
* server_ip - Network related Hostname. If Network related type is Dynamic, Hostname is automatically set to 'dynamic' | |||
* ipaddr - Network related Server IP. If Network related type is Dynamic, Server IP is automatically set to blank | |||
* port - Network related Port, any integer value which is higher than 0. If Network related type is Dynamic, Port is automatically set to 0. | |||
* fromdomain - SIP Specific Fromdomain | |||
<br><br> | |||
<br><br> | <br><br> | ||
===Request=== | ===Request=== |
Revision as of 08:21, 9 August 2022
Description
MOR API for creating providers.
Usage
- From MOR X17 call: /api/provider_create
- Methods: POST, GET(if allowed, not recomended)
Parametres
- u - username to login. Required.
- hash – SHA1 hash constructed using API Secret Key ( More described in Constructing hash). Required.
- name - Provider's name, must be unique Required.
- tech - Technology to use, can be any from (providertypes.name) (dahdi, SIP, IAX2, H323) Required.
- tariff_id - Tariff to use, can be any Provider Tariff (tariffs.purpose == 'provider') Required.
- server_ids - Asterisk Servers, must be in following format "1,3,4", if this parameter is not used, all Asterisk Servers are automatically assigned
- active - 1 for active, 0 for not active
- dtmfmode - DTMF Mode, accepted values [inband, info, rfc2833, auto]. If CCL is active and Provider is SIP, then accepted values are [rfc2833, auto]
- location_id - Any Location (locations) by owner (locations.user_id)
- timeout - Ringing Timeout, any integer value which is equal to 30 or higher
- max_timeout - Call Timeout, any integer value which is equal to 0 or higher
- call_limit - Call Limit, any integer value which is equal to 0 or higher
- balance_limit - Balance limit, any decimal value (value separated by dot ".")
- login - Authentication Login/Username ("anonymous" and "unknown" are not allowed)
- password - Authentication Password
- register - Authentication Register, 0 - Not register, 1 - Register. If Network related type is Dynamic, Register is automatically set to 0
- cid_name - Provider CallerID Name
- cid_number - Provider CallerID Number
- network_type - Network related type, accepted values [hostname ip dynamic]
- server_ip - Network related Hostname. If Network related type is Dynamic, Hostname is automatically set to 'dynamic'
- ipaddr - Network related Server IP. If Network related type is Dynamic, Server IP is automatically set to blank
- port - Network related Port, any integer value which is higher than 0. If Network related type is Dynamic, Port is automatically set to 0.
- fromdomain - SIP Specific Fromdomain
Request
If API Secret Key = secret
You send:
HTML POST: http://<SERVER IP>/billing/api/provider_create?u=admin&name=ApiProvider&tech=SIP&tariff_id=1&server_ids=1&hash=e5e9fa1ba31ecd1ae84f75caaa474f3a663f05f4
* Note that username (u) is not included in the hash
Returns
Success
<?xml version="1.0" encoding="UTF-8"?> <page> <status> <success>Provider created</success> <provider_id>7</provider_id> </status> </page>