\CallFire\Api\Rest\ClientNumber

Summary

Methods
Properties
Constants
QueryRegions()
QueryNumbers()
GetNumber()
ConfigureNumber()
SearchAvailableNumbers()
QueryKeywords()
SearchAvailableKeywords()
CreateNumberOrder()
GetNumberOrder()
Release()
ns()
request()
response()
get()
post()
put()
delete()
buildQuery()
buildPostData()
getBasePath()
setBasePath()
getUsername()
setUsername()
getPassword()
setPassword()
getHttpClone()
getHttp()
setHttp()
getUri()
No public properties found
AMCONFIG_AM_ONLY
AMCONFIG_AM_AND_LIVE
AMCONFIG_LIVE_WITH_AMD
AMCONFIG_LIVE_IMMEDIATE
BROADCAST_VOICE
BROADCAST_IVR
BROADCAST_TEXT
COMMAND_START
COMMAND_STOP
COMMAND_ARCHIVE
EVENT_UNDEFINED_EVENT
EVENT_INBOUND_CALL_FINISHED
EVENT_INBOUND_TEXT_FINISHED
EVENT_OUTBOUND_CALL_FINISHED
EVENT_OUTBOUND_TEXT_FINISHED
EVENT_CAMPAIGN_STARTED
EVENT_CAMPAIGN_STOPPED
EVENT_CAMPAIGN_FINISHED
FEATURE_UNSUPPORTED
FEATURE_PENDING
FEATURE_DISABLED
FEATURE_ENABLED
FORMAT_XML
FORMAT_JSON
FORMAT_SOAP
FORMAT_EMAIL
INBOUND_TRACKING
INBOUND_IVR
RESULT_ANSWER_MACHINE
RESULT_BUSY
RESULT_DO_NOT_CALL
RESULT_TRANSFER
RESULT_TRANSFER_LEG
RESULT_NO_ANSWER
RESULT_UNDIALED
RESULT_SENT
RESULT_RECEIVED
RESULT_DID_NOT_TRY
RESULT_TOO_BIG
RESULT_INTERNAL_ERROR
RESULT_CARRIER_ERROR
RESULT_CARRIER_TEMP_ERROR
STATE_READY
STATE_SELECTED
STATE_FINISHED
STATE_DO_NOT_CALL
STATE_DUPLICATE
STATE_INVALID
STATE_TIMEOUT
STRATEGY_SEND_MULTIPLE
STRATEGY_DO_NOT_SEND
STRATEGY_TRIM
updateCredentials()
$basePath
$username
$password
$http
N/A
No private methods found
No private properties found
N/A

Constants

AMCONFIG_AM_ONLY

AMCONFIG_AM_ONLY

AMCONFIG_AM_AND_LIVE

AMCONFIG_AM_AND_LIVE

AMCONFIG_LIVE_WITH_AMD

AMCONFIG_LIVE_WITH_AMD

AMCONFIG_LIVE_IMMEDIATE

AMCONFIG_LIVE_IMMEDIATE

BROADCAST_VOICE

BROADCAST_VOICE

BROADCAST_IVR

BROADCAST_IVR

BROADCAST_TEXT

BROADCAST_TEXT

COMMAND_START

COMMAND_START

COMMAND_STOP

COMMAND_STOP

COMMAND_ARCHIVE

COMMAND_ARCHIVE

EVENT_UNDEFINED_EVENT

EVENT_UNDEFINED_EVENT

EVENT_INBOUND_CALL_FINISHED

EVENT_INBOUND_CALL_FINISHED

EVENT_INBOUND_TEXT_FINISHED

EVENT_INBOUND_TEXT_FINISHED

EVENT_OUTBOUND_CALL_FINISHED

EVENT_OUTBOUND_CALL_FINISHED

EVENT_OUTBOUND_TEXT_FINISHED

EVENT_OUTBOUND_TEXT_FINISHED

EVENT_CAMPAIGN_STARTED

EVENT_CAMPAIGN_STARTED

EVENT_CAMPAIGN_STOPPED

EVENT_CAMPAIGN_STOPPED

EVENT_CAMPAIGN_FINISHED

EVENT_CAMPAIGN_FINISHED

FEATURE_UNSUPPORTED

FEATURE_UNSUPPORTED

FEATURE_PENDING

FEATURE_PENDING

FEATURE_DISABLED

FEATURE_DISABLED

FEATURE_ENABLED

FEATURE_ENABLED

FORMAT_XML

FORMAT_XML

FORMAT_JSON

FORMAT_JSON

FORMAT_SOAP

FORMAT_SOAP

FORMAT_EMAIL

FORMAT_EMAIL

INBOUND_TRACKING

INBOUND_TRACKING

INBOUND_IVR

INBOUND_IVR

RESULT_ANSWER_MACHINE

RESULT_ANSWER_MACHINE

RESULT_BUSY

RESULT_BUSY

RESULT_DO_NOT_CALL

RESULT_DO_NOT_CALL

RESULT_TRANSFER

RESULT_TRANSFER

RESULT_TRANSFER_LEG

RESULT_TRANSFER_LEG

RESULT_NO_ANSWER

RESULT_NO_ANSWER

RESULT_UNDIALED

RESULT_UNDIALED

RESULT_SENT

RESULT_SENT

RESULT_RECEIVED

RESULT_RECEIVED

RESULT_DID_NOT_TRY

RESULT_DID_NOT_TRY

RESULT_TOO_BIG

RESULT_TOO_BIG

RESULT_INTERNAL_ERROR

RESULT_INTERNAL_ERROR

RESULT_CARRIER_ERROR

RESULT_CARRIER_ERROR

RESULT_CARRIER_TEMP_ERROR

RESULT_CARRIER_TEMP_ERROR

STATE_READY

STATE_READY

STATE_SELECTED

STATE_SELECTED

STATE_FINISHED

STATE_FINISHED

STATE_DO_NOT_CALL

STATE_DO_NOT_CALL

STATE_DUPLICATE

STATE_DUPLICATE

STATE_INVALID

STATE_INVALID

STATE_TIMEOUT

STATE_TIMEOUT

STRATEGY_SEND_MULTIPLE

STRATEGY_SEND_MULTIPLE

STRATEGY_DO_NOT_SEND

STRATEGY_DO_NOT_SEND

STRATEGY_TRIM

STRATEGY_TRIM

Properties

$basePath

$basePath

$username

$username

$password

$password

$http

$http

Methods

QueryRegions()

QueryRegions(\CallFire\Api\Rest\Request\QueryRegions $QueryRegions)

Queries regions for use in subsequent searches and purchase requests

Use a know subset of info on a region to query for the full set of info on a region. Example, if you know the city you can query for phone number prefixes, rate-centers, etc... associated with that city.

Parameters

\CallFire\Api\Rest\Request\QueryRegions $QueryRegions

= null

QueryNumbers()

QueryNumbers(\CallFire\Api\Rest\Request\QueryNumbers $QueryNumbers)

Lists numbers owned by your account

Search for numbers already purchased and in your account by region info such as prefix, city, state, zipcode, rate center, etc... Returns info on the numbers in your account such as status, lease info, configuration, etc...

Parameters

\CallFire\Api\Rest\Request\QueryNumbers $QueryNumbers

= null

GetNumber()

GetNumber(\CallFire\Api\Rest\Request\GetNumber $GetNumber)

Get information about a single number owned by your account

Select number, using 11 digit E.164 format, already purchased and in your account. Returns info on the number in your account such as status, lease info, configuration, etc...

Parameters

\CallFire\Api\Rest\Request\GetNumber $GetNumber

= null

ConfigureNumber()

ConfigureNumber(int $Id, \CallFire\Api\Rest\Request\ConfigureNumber $ConfigureNumber)

Configure a number owned by your account

Update number configuration, such as ENABLE / DISABLE or turn call recording on, using 11 diget E.164 format to select number. No response is returned.

Parameters

int $Id
\CallFire\Api\Rest\Request\ConfigureNumber $ConfigureNumber

SearchAvailableNumbers()

SearchAvailableNumbers(\CallFire\Api\Rest\Request\SearchAvailableNumbers $SearchAvailableNumbers)

Search for new numbers that are available for purchase

Find numbers available for purchase using either TollFree = true or by region info, such as prefix, city, zipcode, etc... The max count of numbers to return must also be specified.

Parameters

\CallFire\Api\Rest\Request\SearchAvailableNumbers $SearchAvailableNumbers

= null

QueryKeywords()

QueryKeywords(\CallFire\Api\Rest\Request\QueryKeywords $QueryKeywords)

Lists keywords owned by your account

Get info such as status, lease dates, etc... on keywords owned by your account.

Parameters

\CallFire\Api\Rest\Request\QueryKeywords $QueryKeywords

= null

SearchAvailableKeywords()

SearchAvailableKeywords(\CallFire\Api\Rest\Request\SearchAvailableKeywords $SearchAvailableKeywords)

Search for keywords available for purchase

Supply list of keywords to see if they are available for purchase. If keyword is available for purchase it will be returned in result. If not available then it will not be returned in result. Once available keywords are found they can be purchase using CreateNumberOrder

Parameters

\CallFire\Api\Rest\Request\SearchAvailableKeywords $SearchAvailableKeywords

= null

CreateNumberOrder()

CreateNumberOrder(\CallFire\Api\Rest\Request\CreateNumberOrder $CreateNumberOrder)

Order new numbers and/or keywords

Purchase numbers and keywords by creating a number order that includes a list of numbers, list of keywords, region info, or specifying toll-free. OrderId is returned from request. Creating a number order is an asynchronous process. The returned orderId can be used in a GetNumberOrder request to see the status of the order. However, there is no guarantee the order will be finished by the time GetNumberOrder is called therefore the GetNumberOrder operation must be polled (no more than once a second) untill the order is in a terminal state (FINISHED or ERRORED). The recommended way to determine if an order is finished is not to poll but to use a Postback. See SubscriptionService for information on registering a postback using subscriptions.

Parameters

\CallFire\Api\Rest\Request\CreateNumberOrder $CreateNumberOrder

= null

GetNumberOrder()

GetNumberOrder(int $Id)

Get the status and results of a previous order

Returns information on the order status, cost, and assets aquired. Since CreateNumberOrder is an asynchronous process this GetNumberOrder operation may need to be polled for up to 20 seconds at a rate of no more than once a second to determine when the order is in a terminal state of FINISHED or ERRORED. Order will be in 'PROCESSING' status untill finished.

Parameters

int $Id

Unique ID of resource

Release()

Release(int $Id, \CallFire\Api\Rest\Request\Release $Release)

Disable auto-renew for a number or keyword

CallFire's system automatically "renews" your numbers and keywords each month and bills you accordingly. When you no longer need a number or keyword, you can easily 'Release' it and stop your recurring monthly charge. Once you release a keyword, you will not be able to repurchase it for a month after the release becomes effective. For example, if your keyword is slated to auto-renew for another month on April 29th, and you release it on April 15th, you will still be able to use it until April 29th. However, you will not be able to repurchase it until May 29th. Therefore, please be sure of your decision before releasing.

Parameters

int $Id
\CallFire\Api\Rest\Request\Release $Release

ns()

ns()

request()

request(string $type) : mixed

Instantiate a request object of the given type

Parameters

string $type

Request type

Returns

mixed —

Request object

response()

response(string $data, string $type) : mixed

Parse a response into a response type

Parameters

string $data

Response data to be parsed

string $type

= 'xml' Response format

Returns

mixed —

Response object

get()

get(string $uri, \CallFire\Api\Rest\Request $request) : string

Execute a GET request against an API endpoint, optionally with a given Request object as parameters

Parameters

string $uri

Endpoint URL

\CallFire\Api\Rest\Request $request

= null Request object for parameters

Returns

string —

Response data

post()

post(string $uri, \CallFire\Api\Rest\Request $request) : string

Execute a POST request against an API endpoint, optionally with a given Request object as parameters

Parameters

string $uri

Endpoint URL

\CallFire\Api\Rest\Request $request

= null Request object for parameters

Returns

string —

Response data

put()

put(string $uri, \CallFire\Api\Rest\Request $request) : string

Execute a PUT request against an API endpoint, optionally with a given Request object as parameters

Parameters

string $uri

Endpoint URL

\CallFire\Api\Rest\Request $request

= null Request object for parameters

Returns

string —

Response data

delete()

delete(string $uri, \CallFire\Api\Rest\Request $request) : string

Execute a DELETE request again an API endpoint, optionally with a given Request object as parameters

Parameters

string $uri

Endpoint URL

\CallFire\Api\Rest\Request $request

= null Request object for parameters

Returns

string —

Response data

buildQuery()

buildQuery(string $uri, array $parameters) : string

Build a request URI for a GET request

Parameters

string $uri

Endpoint URI

array $parameters

Key-value query parameters

Returns

string —

The resulting URL

buildPostData()

buildPostData(array $parameters) : string

Construct the POST fields data for a POST/PUT request, according to CallFire conventions

Reformats any array parameters to be a space-concatenated list of items. Any object parameters will be casted to a string, as possible.

Parameters

array $parameters

POST data

Returns

string —

Encoded POST data

getBasePath()

getBasePath()

setBasePath()

setBasePath( $basePath)

Parameters

$basePath

getUsername()

getUsername()

setUsername()

setUsername( $username)

Parameters

$username

getPassword()

getPassword()

setPassword()

setPassword( $password)

Parameters

$password

getHttpClone()

getHttpClone()

getHttp()

getHttp()

getUri()

getUri( $path,  $parameters)

Parameters

$path
$parameters

updateCredentials()

updateCredentials() : void

Rehashes the HTTP Basic Authentication on the HTTP client