FreeClimb

FreeClimb is a cloud-based application programming interface (API) that puts the power of the Vail platform in your hands. FreeClimb simplifies the process of creating applications that can use a full range of telephony features without requiring specialized or on-site telephony equipment. Using the FreeClimb REST API to write applications is easy! You have the option to use the language of your choice or hit the API directly. Your application can execute a command by issuing a RESTful request to the FreeClimb API. The base URL to send HTTP requests to the FreeClimb REST API is: /apiserver. FreeClimb authenticates and processes your request.

This SDK is automatically generated by the OpenAPI Generator project:

  • API version: 1.0.0
  • Package version: 2.0.0
  • Build package: org.openapitools.codegen.languages.RubyClientCodegen

Installation

Build a gem

To build the Ruby code into a gem:

gem build freeclimb.gemspec

Then either install the gem locally:

gem install ./freeclimb-2.0.0.gem

(for development, run gem install --dev ./freeclimb-2.0.0.gem to install the development dependencies)

or publish the gem to a gem hosting service, e.g. RubyGems.

Finally add this to the Gemfile:

gem 'freeclimb', '~> 2.0.0'

Install from Ruby gems

gem install freeclimb

Install from Git

If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:

gem 'freeclimb', :git => 'https://github.com/GIT_USER_ID/GIT_REPO_ID.git'

Include the Ruby code directly

Include the Ruby code directly using -I as follows:

ruby -Ilib script.rb

Testing Your Installation

Please follow the installation procedure and then run the following code:

# Load the gem
require 'freeclimb'

# Setup authorization
Freeclimb.configure do |config|
  # Configure HTTP basic authorization: fc
  config.username = 'ACCOUNT_ID'
  config.password = 'AUTH_TOKEN'
end

api_instance = Freeclimb::DefaultApi.new

begin
  #Get an Account
  result = api_instance.
  p result
rescue Freeclimb::ApiError => e
  puts "Exception when calling DefaultApi->get_an_account: #{e}"
end

Documentation for PerCL

The Performance Command Language (PerCL) defines a set of instructions, written in JSON format, that express telephony actions to be performed in response to an event on the FreeClimb platform. FreeClimb communicates with the application server when events associated with the application occur, so the webserver can instruct FreeClimb how to handle such events using PerCL scripts. PerCL commands are a part of the model schema and can be serialized into JSON like so:

require 'freeclimb'

say = Freeclimb::Say.new(text: "Hello, World")
play = Freeclimb::Play.new(file: "Example File")
get_digits = Freeclimb::GetDigits.new(action_url: "Example Action URL", prompts: [say, play])
percl_script = Freeclimb::PerclScript.new(commands: [get_digits])
puts Freeclimb::percl_to_json(percl_script)

Documentation for API Endpoints

All URIs are relative to https://www.freeclimb.com/apiserver

Class Method HTTP request Description
Freeclimb::DefaultApi get_an_account GET /Accounts/accountId Get an Account
Freeclimb::DefaultApi buy_a_phone_number POST /Accounts/accountId/IncomingPhoneNumbers Buy a Phone Number
Freeclimb::DefaultApi create_a_conference POST /Accounts/accountId/Conferences Create a Conference
Freeclimb::DefaultApi create_a_queue POST /Accounts/accountId/Queues Create a Queue
Freeclimb::DefaultApi create_an_application POST /Accounts/accountId/Applications Create an application
Freeclimb::DefaultApi delete_a_recording DELETE /Accounts/accountId/Recordings/recordingId Delete a Recording
Freeclimb::DefaultApi delete_an_application DELETE /Accounts/accountId/Applications/applicationId Delete an application
Freeclimb::DefaultApi delete_an_incoming_number DELETE /Accounts/accountId/IncomingPhoneNumbers/phoneNumberId Delete an Incoming Number
Freeclimb::DefaultApi dequeue_a_member POST /Accounts/accountId/Queues/queueId/Members/callId Dequeue a Member
Freeclimb::DefaultApi dequeue_head_member POST /Accounts/accountId/Queues/queueId/Members/Front Dequeue Head Member
Freeclimb::DefaultApi download_a_recording_file GET /Accounts/accountId/Recordings/recordingId/Download Download a Recording File
Freeclimb::DefaultApi filter_logs POST /Accounts/accountId/Logs Filter Logs
Freeclimb::DefaultApi get_a_call GET /Accounts/accountId/Calls/callId Get a Call
Freeclimb::DefaultApi get_a_conference GET /Accounts/accountId/Conferences/conferenceId Get a Conference
Freeclimb::DefaultApi get_a_member GET /Accounts/accountId/Queues/queueId/Members/callId Get a Member
Freeclimb::DefaultApi get_a_participant GET /Accounts/accountId/Conferences/conferenceId/Participants/callId Get a Participant
Freeclimb::DefaultApi get_a_queue GET /Accounts/accountId/Queues/queueId Get a Queue
Freeclimb::DefaultApi get_a_recording GET /Accounts/accountId/Recordings/recordingId Get a Recording
Freeclimb::DefaultApi get_an_application GET /Accounts/accountId/Applications/applicationId Get an Application
Freeclimb::DefaultApi get_an_incoming_number GET /Accounts/accountId/IncomingPhoneNumbers/phoneNumberId Get an Incoming Number
Freeclimb::DefaultApi get_an_sms_message GET /Accounts/accountId/Messages/messageId Get an SMS Message
Freeclimb::DefaultApi get_head_member GET /Accounts/accountId/Queues/queueId/Members/Front Get Head Member
Freeclimb::DefaultApi list_active_queues GET /Accounts/accountId/Queues List Active Queues
Freeclimb::DefaultApi list_all_account_logs GET /Accounts/accountId/Logs List All Account Logs
Freeclimb::DefaultApi list_an_application GET /Accounts/accountId/Applications List applications
Freeclimb::DefaultApi list_available_numbers GET /AvailablePhoneNumbers List available numbers
Freeclimb::DefaultApi list_call_logs GET /Accounts/accountId/Calls/callId/Logs List Call Logs
Freeclimb::DefaultApi list_call_recordings GET /Accounts/accountId/Calls/callId/Recordings List Call Recordings
Freeclimb::DefaultApi list_calls GET /Accounts/accountId/Calls List Calls
Freeclimb::DefaultApi list_conferences GET /Accounts/accountId/Conferences List Conferences
Freeclimb::DefaultApi list_incoming_numbers GET /Accounts/accountId/IncomingPhoneNumbers List Incoming Numbers
Freeclimb::DefaultApi list_members GET /Accounts/accountId/Queues/queueId/Members List Members
Freeclimb::DefaultApi list_participants GET /Accounts/accountId/Conferences/conferenceId/Participants List Participants
Freeclimb::DefaultApi list_recordings GET /Accounts/accountId/Recordings List Recordings
Freeclimb::DefaultApi list_sms_messages GET /Accounts/accountId/Messages List SMS Messages
Freeclimb::DefaultApi make_a_call POST /Accounts/accountId/Calls Make a Call
Freeclimb::DefaultApi remove_a_participant DELETE /Accounts/accountId/Conferences/conferenceId/Participants/callId Remove a Participant
Freeclimb::DefaultApi send_an_sms_message POST /Accounts/accountId/Messages Send an SMS Message
Freeclimb::DefaultApi stream_a_recording_file GET /Accounts/accountId/Recordings/recordingId/Stream Stream a Recording File
Freeclimb::DefaultApi update_a_conference POST /Accounts/accountId/Conferences/conferenceId Update a Conference
Freeclimb::DefaultApi update_a_live_call POST /Accounts/accountId/Calls/callId Update a Live Call
Freeclimb::DefaultApi update_a_participant POST /Accounts/accountId/Conferences/conferenceId/Participants/callId Update a Participant
Freeclimb::DefaultApi update_a_queue POST /Accounts/accountId/Queues/queueId Update a Queue
Freeclimb::DefaultApi update_an_account POST /Accounts/accountId Manage an account
Freeclimb::DefaultApi update_an_application POST /Accounts/accountId/Applications/applicationId Update an application
Freeclimb::DefaultApi update_an_incoming_number POST /Accounts/accountId/IncomingPhoneNumbers/phoneNumberId Update an Incoming Number

Documentation for Models

Documentation for Authorization

fc

  • Type: HTTP basic authentication