MOR API provider create

From Kolmisoft Wiki
Jump to navigationJump to search

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>

See also