Providers

Providers ⇐ APIClient

Use Fonoster Providers, a capability of Fonoster SIP Proxy subsystem, to create, update, get and delete providers. Fonoster Providers requires of a running Fonoster deployment.

Kind: global class
Extends: APIClient
See: module:core:APIClient

• Providers ⇐ APIClient
  • new Providers(options)
  • .createProvider(request) ⇒ Promise.<Object>
  • .getProvider(ref) ⇒ Promise.<Object>
  • .updateProvider(request) ⇒ Promise.<Object>
  • .listProviders(request) ⇒ Promise.<ListProvidersResponse>
  • .deleteProvider(ref)

new Providers(options)

Constructs a new Providers object.

Param	Type	Description
options	ClientOptions	Options to indicate the objects endpoint

Example

const Fonoster = require("@fonoster/sdk");
const providers = new Fonoster.Providers();

const request = {
  name: "SIP Provider",
  username: "trunk001",
  secret: "secretkey",
  host: "sip.provider.net"
};

providers.createProvider(request)
.then(result => {
  console.log(result)             // successful response
}).catch(e => console.error(e));   // an error occurred

providers.createProvider(request) ⇒ Promise.<Object>

Creates a new Provider on the SIP Proxy subsystem.

Kind: instance method of Providers

Param	Type	Description
request	Object	Request for the provision of a new Provider
request.name	string	Friendly name to the Provider
request.username	string	Username for the trunk. No required for static IP authentication
request.secret	string	Password for the trunk. No required for static IP authentication
request.host	string	Hostname or IP of the Provider
request.transport	string	The transport for the Provider. Fonoster will use TCP if none is provided
request.expires	string	Expiration time for the registration. Fonoster will use 3600 if none is provided

Example

const request = {
  name: "Provider Name",
  username: "trunk001",
  secret: "secretkey",
  host: "sip.provider.net"
};

providers.createProvider(request)
.then(result => {
  console.log(result)            // returns the Provider object
}).catch(e => console.error(e));  // an error occurred

providers.getProvider(ref) ⇒ Promise.<Object>

Retrives a Provider by its reference.

Kind: instance method of Providers
Returns: Promise.<Object> - The provider
Throws:

• if ref is null or Provider does not exist

Param	Type	Description
ref	string	Reference to Provider

Example

providers.getProvider(ref)
.then(result => {
  console.log(result)             // returns the Provider object
}).catch(e => console.error(e));   // an error occurred

providers.updateProvider(request) ⇒ Promise.<Object>

Update a Provider at the SIP Proxy subsystem.

Kind: instance method of Providers

Param	Type	Description
request	Object	Request to update a Provider
request.ref	string	Providers reference
request.name	string	Friendly name to the Provider
request.username	string	Username for the trunk. No required for static IP authentication
request.secret	string	Password for the trunk. No required for static IP authentication
request.host	string	Hostname or IP of the Provider
request.transport	string	The transport for the Provider. Fonoster will use TCP if none is provided
request.expires	string	Expiration time for the registration. Fonoster will use 3600 if none is provided

Example

const request = {
  ref: "hYTHYCYv_U",
  host: "sip.provider.net"
};

providers.updateProvider(request)
.then(result => {
  console.log(result)            // returns the Provider from the DB
}).catch(e => console.error(e));  // an error occurred

providers.listProviders(request) ⇒ Promise.<ListProvidersResponse>

List the Providers registered in Fonoster SIP Proxy subsystem.

Kind: instance method of Providers
Returns: Promise.<ListProvidersResponse> - List of Providers

Param	Type	Description
request	Object
request.pageSize	provider	Provider of element per page (defaults to 20)
request.pageToken	string	The next_page_token value returned from a previous List request, if any

Example

const request = {
   pageSize: 20,
   pageToken: 2
};

providers.listProviders(request)
.then(() => {
  console.log(result)            // returns a ListProvidersResponse object
}).catch(e => console.error(e));  // an error occurred

providers.deleteProvider(ref)

Deletes a Provider from SIP Proxy subsystem. Notice, that in order to delete a Provider, you must first delete all it"s Agents.

Kind: instance method of Providers

Param	Type	Description
ref	string	Reference to the Provider

Example

const ref = "hYTHYCYv_U";

providers.deleteProvider(ref)
.then(() => {
  console.log("done")            // returns an empty object
}).catch(e => console.error(e));  // an error occurred