Difference between revisions of "MOR API provider create"
From Kolmisoft Wiki
Jump to navigationJump to search
(→Usage) |
|||
(2 intermediate revisions by 2 users not shown) | |||
Line 8: | Line 8: | ||
* From '''MOR X17''' call: '''/api/provider_create''' | * From '''MOR X17''' call: '''/api/provider_create''' | ||
* Methods: POST, GET(if allowed, not recomended) | * Methods: POST, GET(if allowed, not recomended) | ||
* Only Admin can use this API. | |||
<br><br> | <br><br> | ||
===Parametres=== | ===Parametres=== | ||
Line 34: | Line 35: | ||
* port - Network related Port, any integer value which is higher than 0. If Network related type is Dynamic, Port is automatically set to 0. | * 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 | * fromdomain - SIP Specific Fromdomain | ||
* fromuser - SIP Specific Fromuser | |||
<br><br> | <br><br> | ||
<br><br> | <br><br> | ||
Line 43: | Line 45: | ||
HTML POST: http://<SERVER IP>/billing/api/provider_create?u=admin&name=ApiProvider&tech=SIP&tariff_id=1&server_ids=1&hash=e5e9fa1ba31ecd1ae84f75caaa474f3a663f05f4 | HTML POST: http://<SERVER IP>/billing/api/provider_create?u=admin&name=ApiProvider&tech=SIP&tariff_id=1&server_ids=1&hash=e5e9fa1ba31ecd1ae84f75caaa474f3a663f05f4 | ||
<br><br> | <br><br> | ||
===Returns=== | ===Returns=== | ||
Line 57: | Line 59: | ||
</page> | </page> | ||
---- | ---- | ||
=See also= | =See also= | ||
* [[MOR API]] | * [[MOR API]] |
Latest revision as of 07:20, 8 December 2023
Description
MOR API for creating providers.
Usage
- From MOR X17 call: /api/provider_create
- Methods: POST, GET(if allowed, not recomended)
- Only Admin can use this API.
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
- fromuser - SIP Specific Fromuser
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
Returns
Success
<?xml version="1.0" encoding="UTF-8"?> <page> <status> <success>Provider created</success> <provider_id>7</provider_id> </status> </page>