About
This repository contains the ruby client library for the Asterisk REST Interface (ARI). It uses the swagger ARI json definitions to generate ruby classes.
Installation
Add this line to your application's Gemfile:
gem 'asterisk-ari-client'And then execute:
$ bundle
Or install it yourself as:
$ gem install asterisk-ari-client
and then require it:
require 'asterisk/ari/client'Usage
# instantiate client
@client = Ari::Client.new(
url: 'http://127.0.0.1:8088/ari',
api_key: 'asterisk:asterisk',
app: 'my-app'
)
# originate
@client.channels.originate endpoint: 'PJSIP/endpoint-name', extension: 11
# list all channels
channels = @client.channels.listWhen working with only one client you can also use the following:
Ari.client = Ari::Client.new(
url: 'http://127.0.0.1:8088/ari',
api_key: 'asterisk:asterisk',
app: 'my-app'
)
# list channels
channels = Ari::Channel.listWebSocket events
# listen to events
@client.on :websocket_open do
puts "Connected !"
end
@client.on :stasis_start do |e|
puts "Received call to #{e.channel.dialplan.exten} !"
e.channel.answer
e.channel.on :channel_dtmf_received do |e|
puts "Digit pressed: #{e.digit} on channel #{e.channel.name} !"
end
e.channel.on :stasis_end do |e|
puts "Channel #{e.channel.name} left Stasis."
end
end
# start websocket to receive events
@client.connect_websocket
sleepContributing
- Fork it ( https://github.com/svoboda-jan/asterisk-ari/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request