bulutfon_sdk 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 610b26a347f122153a6acdf77a417006c5bf37ef
+  data.tar.gz: 21139f64c0523051983af4060097a3db56aa15d2
+SHA512:
+  metadata.gz: 94b485248c99027342e3ce0961f1b926630632783dddce50d27693f522458bdd0ef617d0dcf8d3a971e038bc87c081c369cfc8a3fb879b842870af93c063aa5d
+  data.tar.gz: ef1d317c011859c251228c1e1d7ba9e18c9686b7984ee4710bdaf5edeb6e042b568d71ade207df844f363b7f8f86c51ce2af3a2fc1d27704020b74c41d2d647e

data/.gitignore

@@ -0,0 +1,18 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*~
+.*
+pkg/*
+doc/*
+Gemfile.lock
+*.gem
+bin
+docs/_build
+.DS_Store

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in bulutfon_sdk.gemspec
+gemspec

data/LICENSE.md

@@ -0,0 +1,21 @@
+Copyright (c) 2014-2015 Bulutfon
+
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,279 @@
+# Bulutfon Ruby SDK
+
+* [API Dokümantasyonu](https://github.com/bulutfon/documents/tree/master/API)
+* [Örnek Kodlar](https://github.com/bulutfon/ruby-sdk/tree/master/examples)
+
+## Kullanım
+
+### Kurulum
+
+Gemfile dosyanıza şu satırı ekleyiniz
+
+```  ruby
+gem 'bulutfon_sdk'
+```
+	
+Bu satırı ekledikten sonra,
+
+```  bash
+bundle install
+```
+komutunu koşarak gerekli paketleri yükledikten sonra BulutfonSDK'yı kullanmaya başlayabilirsiniz.
+
+### Master Token ile
+
+```ruby
+require 'bulutfon_sdk'
+
+token = 'your_token'
+bulutfon = BulutfonSDK::REST::Bulutfon.new(token)
+```
+
+## İşlevler
+
+### Kullanıcı bilgilerine erişme
+
+SDK ile Kullanıcı bilgileriniz, panel bilgileriniz ve kalan kredinize erişebilirsiniz.
+Bunun için 
+
+``` ruby
+puts bulutfon.details
+```
+
+methodunu kullanabilirsiniz.
+
+### Telefon numaraları ve telefon numara detaylarına erişme
+
+Bunun için;
+
+```ruby
+# Santral listesine erişir
+puts bulutfon.dids.all    
+# Id'si verilen santral detayını döndürür
+puts bulutfon.dids.get(1)  
+```
+
+methodlarını kullanabilirsiniz.
+
+### Dahililere ve dahili detaylarına erişme, dahili oluşturma, güncelleme ve silme
+
+Bunun için;
+
+```ruby
+# Dahili listesine erişir
+puts bulutfon.extensions.all     
+# Id'si verilen dahili detayını döndürür
+puts bulutfon.extensions.get(1)  
+# Verilen parametrelere göre yeni dahili oluşturur.
+params = {
+    full_name: 'Deneme',
+    email: 'deneme@deneme.com',
+    did: '905xxxxxxxxx',
+    number: 9999,
+    redirection_type: 'NONE',
+    destination_type: 'EXTENSION',
+    destination_number: '905xxxxxxxxx',
+    'acl[]' => [ 'domestic', 'gsm', 'international']
+}
+puts bulutfon.extensions.create(params)    
+# Verilen parametrelere göre dahiliyi günceller
+params = {
+    full_name: 'Deneme Deneme',
+    'acl[]' => [ 'domestic', 'gsm']
+}
+puts bulutfon.extensions.update(1, params)  
+# Dahiliyi siler
+puts bulutfon.extensions.delete(1)              
+```
+
+methodlarını kullanabilirsiniz.
+
+### Gruplara ve grup detaylarına erişme
+
+Bunun için;
+
+```ruby
+# Grup listesine erişir
+puts bulutfon.groups.all     
+# Id'si verilen grup detayını döndürür 
+puts bulutfon.groups.get(1)  
+```
+
+methodlarını kullanabilirsiniz.
+
+### Arama kayıtlarına ve arama detaylarına erişme ve ses kayıtlarını indirme
+
+Bunun için;
+
+```ruby
+# Cdr listesine erişir
+puts bulutfon.cdrs.all                      
+# Cdr listesine sayfalama yaparak erişir
+puts bulutfon.cdrs.all({page: 1, limit: 3}) 
+# Uuid'si verilen cdr detayını döndürür 
+puts bulutfon.cdrs.get('uuid')              
+# Uuid'si verilen arama kaydinin detaylarini getir 
+puts bulutfon.call_records.get('uuid')         
+# Uuid'si verilen ses kaydını indir
+save_path = "#{File.expand_path(File.dirname(__FILE__))}/save_uuid.ogg"
+puts bulutfon.call_records.save('uuid', save_path)
+```
+
+methodlarını kullanabilirsiniz.
+
+### Gelen fakslara erişme ve faks dosyasını indirme
+
+Bunun için;
+
+```ruby
+# Gelen faksları listeler
+puts bulutfon.incoming_faxes.all  
+# Uuid'si verilen gelen faksın detayları
+puts  bulutfon.incoming_faxes.get('uuid')
+# Uuid'si verilen gelen faksı indir
+save_path = "#{File.expand_path(File.dirname(__FILE__))}/save_uuid.tiff"
+puts  bulutfon.incoming_faxes.save('uuid', save_path)
+```
+
+methodlarını kullanabilirsiniz.
+
+### Giden fakslara erişme ve faks gönderme
+
+Bunun için;
+
+```ruby
+# Giden faksları listeler 
+puts bulutfon.outgoing_faxes.all
+# Id'si verilen giden faks detayları
+puts bulutfon.outgoing_faxes.get(1)
+# Faks gönderme işlemi
+file = "#{File.expand_path(File.dirname(__FILE__))}/pdf-sample.pdf"
+params = {
+    title: 'Deneme',
+    receivers: '905xxxxxxxxx',
+    did: '905xxxxxxxxx', 
+    attachment: file
+}
+puts bulutfon.outgoing_faxes.create(params)
+```
+
+methodlarını kullanabilirsiniz.
+    
+### Ses Dosyalarını listeleme ve indirme, oluşturma ve silme
+
+Bunun için;
+
+```ruby
+# Ses Dosyalarını listeler 
+puts bulutfon.announcements.all 
+# Id'si verilen ses dosyasının detayları
+puts bulutfon.announcements.get(1)
+# Ses dosyası oluşturma
+file = "#{File.expand_path(File.dirname(__FILE__))}/test.wav"
+params = {
+    name: 'Deneme',
+    announcement: file
+}
+puts bulutfon.announcements.create(params)
+# Id'si verilen ses dosyasını indirme işlemi
+save_path = "#{File.expand_path(File.dirname(__FILE__))}/save_test.wav"
+puts bulutfon.announcements.save(1, save_path)
+# Id'si verilen ses dosyasını silme
+puts bulutfon.announcements.delete(1)
+```
+
+methodlarını kullanabilirsiniz.
+
+### Otomatik Aramaları listeleme ve oluşturma
+
+Bunun için;
+
+```ruby
+puts bulutfon.automatic_calls.all    # Otomatik aramaları listeler
+puts bulutfon.automatic_calls.get(1) # Id'si verien otomatik arama detaylarını görüntüler 
+# Automatic call oluşturur ve oluşturmadan sonra receivers numaraları aranır
+params = {
+    title: 'Automatic call after creation',
+    receivers: '905xxxxxxxxx',
+    did: '905xxxxxxxxx',
+    announcement_id: 1
+}
+puts bulutfon.automatic_calls.create(params)
+# Zaman planlı automatic call oluşturulur ve oluşturmadan sonra receivers numaraları 
+# perşembe günü saat 10:15 ile 12:00 arasında aranır
+params = {
+    title: 'Time planned call',
+    receivers: '905xxxxxxxxx',
+    did: '905xxxxxxxxx',
+    announcement_id: 1,
+    mon_active: false,
+    tue_active: false,
+    wed_active: false,
+    thu_active: true,
+    thu_start: '10:15',
+    thu_finish: '12:00',
+    fri_active: false,
+    sat_active: false,
+    sun_active: false,
+    hours_active: true
+}
+puts bulutfon.automatic_calls.create(params)
+```
+
+methodlarını kullanabilirsiniz.
+
+### Sms Başlıklarını Listeleme
+
+Bunun için;
+
+```ruby
+# Panelden oluşturduğunuz sms başlıklarını listeler
+puts bulutfon.message_titles.all 
+```
+
+methodlarını kullanabilirsiniz.
+
+### Mesajları Listeleme ve Mesaj Gönderme
+
+Bunun için;
+
+```ruby
+# Gönderilen mesajları listeler
+puts bulutfon.messages.all 
+# Gönderilen mesajları sayfalama yaparak listeler 
+puts bulutfon.messages.all({page: 1, limit: 3 })
+# Id'si verilen mesaj detaylarını döndürür
+puts bulutfon.messages.get(1)
+# Yeni mesaj gönderme işlemi
+params = {
+    title: 'CONFIRMED_MESSAGE_TITLE',
+    content: 'Test Message',
+    receivers: '905xxxxxxxxx'
+}
+puts bulutfon.messages.create(params)
+# Çoklu alıcılı mesaj gönderme işlemi
+params_multiple = {
+    title: 'CONFIRMED_MESSAGE_TITLE',
+    content: 'Multiple Message',
+    receivers: '905xxxxxxxxx,905xxxxxxxxx'
+}
+puts bulutfon.messages.create(params_multiple)
+# Zaman planlı mesaj gönderme işlemi
+params = {
+    title: 'CONFIRMED_MESSAGE_TITLE',
+    content: 'Planned message example',
+    receivers: '905xxxxxxxxx',
+    is_future_sms: true,
+    send_date: '16/12/2015 10:00'
+}
+puts bulutfon.messages.create(params)
+```
+
+methodlarını kullanabilirsiniz.
+
+Örnek kullanımları görmek için ve erişebileceğiniz değişkenler için [örnek kodlarımızı](https://github.com/bulutfon/ruby-sdk/tree/master/examples) inceleyebilirsiniz.
+    
+##Credits
+* ruby_sdk is maintained by [Lab2023](http://lab2023.com/) & [Bulutfon](https://www.bulutfon.com/)
+* Thank you to all the contributors!
+* The names and logos for Bulutfon are trademarks of Bulutfon

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bulutfon_sdk.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bulutfon_sdk/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'bulutfon_sdk'
+  spec.version       = BulutfonSDK::VERSION
+  spec.authors       = ['Ismail Akbudak']
+  spec.email         = ['ismail.akbudak@lab2023.com']
+
+  spec.summary          = %q{Bulutfon Ruby SDK.}
+  spec.description      = %q{Bulutfon API SDK for ruby & ruby on rails.}
+  spec.homepage         = 'https://github.com/bulutfon/ruby-sdk'
+  spec.extra_rdoc_files = ['README.md', 'LICENSE.md']
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'multi_json', '~> 1.11', '>= 1.11.0'
+  spec.add_dependency('mime-types', '~> 3.0')
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 0'
+end

data/examples/examples.rb

@@ -0,0 +1,216 @@
+require 'bulutfon_sdk'
+
+token = 'your_token'
+
+# Account
+# -------------------------------------------------------------
+bulutfon = BulutfonSDK::REST::Bulutfon.new(token)
+# Get account details
+puts bulutfon.details
+# BulutfonSDK::REST::Message object
+puts bulutfon.messages
+# BulutfonSDK::REST::MessageTitle object
+puts bulutfon.message_titles
+# BulutfonSDK::REST::Did object
+puts bulutfon.dids
+# BulutfonSDK::REST::Extension object
+puts bulutfon.extensions
+# BulutfonSDK::REST::Group object
+puts bulutfon.groups
+# BulutfonSDK::REST::Cdr object
+puts bulutfon.cdrs
+# BulutfonSDK::REST::CallRecord object
+puts bulutfon.call_records
+# BulutfonSDK::REST::IncomingFax object
+puts bulutfon.incoming_faxes
+# BulutfonSDK::REST::OutgoingFax object
+puts bulutfon.outgoing_faxes
+# BulutfonSDK::REST::Announcement object
+puts bulutfon.announcements
+# BulutfonSDK::REST::AutomaticCall object
+puts bulutfon.automatic_calls
+
+# Dids
+# -------------------------------------------------------------
+did = BulutfonSDK::REST::Did.new(token)
+# Get dids
+puts did.all
+# Get did with id
+puts did.get(1)
+
+# Extensions
+# -------------------------------------------------------------
+extension = BulutfonSDK::REST::Extension.new(token)
+# Get extensions
+puts extension.all
+# Get extension with id
+puts extension.get(1)
+# Create extension
+params = {
+    full_name: 'Deneme',
+    email: 'deneme@deneme.com',
+    did: '905xxxxxxxxx',
+    number: 9999,
+    redirection_type: 'NONE',
+    destination_type: 'EXTENSION',
+    destination_number: '905xxxxxxxxx',
+    'acl[]' => [ 'domestic', 'gsm', 'international']
+}
+puts extension.create(params)
+# Update extension
+params = {
+    full_name: 'Deneme Deneme',
+    'acl[]' => [ 'domestic', 'gsm']
+}
+puts extension.update(1, params)
+# Delete extension
+puts extension.delete(1)
+
+# Groups
+# -------------------------------------------------------------
+group = BulutfonSDK::REST::Group.new(token)
+# Get groups
+puts group.all
+# Get group with id
+puts group.get(1)
+
+# Cdrs
+# -------------------------------------------------------------
+cdr = BulutfonSDK::REST::Cdr.new(token)
+# Get cdrs
+puts cdr.all
+# Get cdrs with pagination
+puts cdr.all({page: 1, limit: 1})
+# Get cdr with uuid
+puts cdr.get('uuid')
+
+# Call Records
+# -------------------------------------------------------------
+call_record = BulutfonSDK::REST::CallRecord.new(token)
+# Get call_record detail with uuid
+puts call_record.get('uuid')
+# Save call record to save_path with uuid
+save_path = "#{File.expand_path(File.dirname(__FILE__))}/save_uuid.ogg"
+puts call_record.save('uuid', save_path)
+
+# Incoming Faxes
+# -------------------------------------------------------------
+incoming_fax = BulutfonSDK::REST::IncomingFax.new(token)
+# Get incoming faxes
+puts incoming_fax.all
+# Get incoming fax with uuid
+puts incoming_fax.get('uuid')
+# Save incoming fax to save_path with uuid
+save_path = "#{File.expand_path(File.dirname(__FILE__))}/save_uuid.tiff"
+puts incoming_fax.save('uuid', save_path)
+
+# Outgoing Faxes
+# -------------------------------------------------------------
+outgoing_fax = BulutfonSDK::REST::OutgoingFax.new(token)
+# Get outgoing faxes
+puts outgoing_fax.all
+# Get outgoing fax with id
+puts outgoing_fax.get(1)
+# Create outgoing faxes
+file = "#{File.expand_path(File.dirname(__FILE__))}/pdf-sample.pdf"
+params = {
+    title: 'Deneme',
+    receivers: '905xxxxxxxxx',
+    did: '905xxxxxxxxx',
+    attachment: file
+}
+puts outgoing_fax.create(params)
+
+# Announcements
+# -------------------------------------------------------------
+announcement = BulutfonSDK::REST::Announcement.new(token)
+# Get announcements
+puts announcement.all
+# Get announcement with id
+puts announcement.get(1)
+# Create announcement
+file = "#{File.expand_path(File.dirname(__FILE__))}/test.wav"
+params = {
+    name: 'Deneme',
+    announcement: file
+}
+puts announcement.create(params)
+# Save announcement file to save_path with id
+save_path = "#{File.expand_path(File.dirname(__FILE__))}/save_test.wav"
+puts announcement.save(1, save_path)
+# Delete announcement with id
+puts announcement.delete(1)
+
+# Automatic Calls
+# -------------------------------------------------------------
+automatic_call = BulutfonSDK::REST::AutomaticCall.new(token)
+# Get automatic calls
+puts automatic_call.all
+# Get automatic call with id
+puts automatic_call.get(1)
+# Create automatic call, after creation receivers will call
+params = {
+    title: 'Automatic call after creation',
+    receivers: '905xxxxxxxxx',
+    did: '905xxxxxxxxx',
+    announcement_id: 1
+}
+puts automatic_call.create(params)
+# Create time planned automatic call, in this params receivers will be calling on thursday between 10:15, 12:00
+params = {
+    title: 'Time planned call',
+    receivers: '905xxxxxxxxx',
+    did: '905xxxxxxxxx',
+    announcement_id: 1,
+    mon_active: false,
+    tue_active: false,
+    wed_active: false,
+    thu_active: true,
+    thu_start: '10:15',
+    thu_finish: '12:00',
+    fri_active: false,
+    sat_active: false,
+    sun_active: false,
+    hours_active: true
+}
+puts automatic_call.create(params)
+
+# Message Titles
+# -------------------------------------------------------------
+message_title = BulutfonSDK::REST::MessageTitle.new(token)
+# Get message titles
+puts message_title.all
+
+# Messages
+# -------------------------------------------------------------
+message = BulutfonSDK::REST::Message.new(token)
+# Get messages
+puts message.all
+# Get messages with pagination
+puts message.all({page: 1, limit: 3 })
+# Get message with id
+puts message.get(1)
+# Create message
+params = {
+    title: 'CONFIRMED_MESSAGE_TITLE',
+    content: 'Test Message',
+    receivers: '905xxxxxxxxx'
+}
+puts message.create(params)
+# Create message for multiple receiver
+params_multiple = {
+    title: 'CONFIRMED_MESSAGE_TITLE',
+    content: 'Multiple Message',
+    receivers: '905xxxxxxxxx,905xxxxxxxxx'
+}
+puts message.create(params_multiple)
+# Create time planned message
+params = {
+    title: 'CONFIRMED_MESSAGE_TITLE',
+    content: 'Planned message example',
+    receivers: '905xxxxxxxxx',
+    is_future_sms: true,
+    send_date: '16/12/2015 10:00'
+}
+puts message.create(params)
+

data/lib/bulutfon_sdk/rest/announcement.rb

@@ -0,0 +1,49 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class Announcement < BaseRequest
+
+      include BulutfonSDK::Util
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'announcements'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource,params)
+      end
+
+      def get( id )
+        uri = prepare_uri("#{@resource}/#{id}")
+        { download_path: uri.to_s }
+      end
+
+      def save( id, save_path)
+        save_file( 'get', "#{@resource}/#{id}", save_path)
+      end
+
+      def create(params)
+        prepare_atachment(params)
+        prepare_request( 'post', @resource, params)
+      end
+
+      def delete(id)
+        prepare_request( 'delete', "#{@resource}/#{id}")
+      end
+
+      private
+
+      def prepare_atachment(params)
+        file          = params[:announcement]
+        basename      = File.basename file
+        type          = file_content_type file
+        content       = File.read(file)
+        base_64_data  = Base64.strict_encode64(content)
+        params[:announcement] = "data:#{type};name:#{basename};base64:#{base_64_data}"
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/automatic_call.rb

@@ -0,0 +1,26 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class AutomaticCall < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'automatic-calls'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource, params)
+      end
+
+      def get( id )
+        prepare_request( 'get', "#{@resource}/#{id}")
+      end
+
+      def create(params)
+        prepare_request( 'post', @resource, params)
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/base_request.rb

@@ -0,0 +1,117 @@
+module BulutfonSDK
+  module REST
+    class BaseRequest
+
+      HTTP_HEADERS = {
+          'Accept'          => 'application/json',
+          'Accept-Charset'  => 'utf-8',
+          'User-Agent'      => "bulutfon_sdk/#{BulutfonSDK::VERSION}" " (#{RUBY_ENGINE}/#{RUBY_PLATFORM}" " #{RUBY_VERSION}-p#{RUBY_PATCHLEVEL})"
+      }
+
+      def initialize(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        @config = BulutfonSDK::Util::ClientConfig.new options
+        @token = args[0] || nil
+        raise ArgumentError, 'Auth token is required' if @token.nil?
+        set_up_connection
+      end
+
+      protected
+
+      ##
+      # Prepare URI object for file path
+      def prepare_uri(path, params = {})
+        request_path          = "#{@config.host}/#{path}"
+        uri                   = URI.parse(request_path)
+        params[:access_token] = @token
+        uri.query             = URI.encode_www_form(params)
+        uri
+      end
+
+      ##
+      # Prepare http request
+      def prepare_request(method, path, params = {})
+        request_path          = "#{@config.host}/#{path}"
+        uri                   = URI.parse(request_path)
+        params[:access_token] = @token
+        uri.query             = URI.encode_www_form(params) if ['get', 'delete'].include?(method)
+        method_class          = Net::HTTP.const_get method.to_s.capitalize
+        request               = method_class.new(uri.to_s, HTTP_HEADERS)
+        request.form_data     = params if ['post', 'put'].include?(method)
+        connect_and_send(request)
+      end
+
+      ##
+      # Prepare http request for file saving
+      def save_file(method, path, save_path)
+        uri          = prepare_uri(path)
+        method_class = Net::HTTP.const_get method.to_s.capitalize
+        request      = method_class.new(uri.to_s, HTTP_HEADERS)
+        response     = connect_and_send(request, is_file: true )
+        begin
+          file = File.open(save_path, 'w')
+          file.write(response)
+        rescue => error
+          raise BulutfonSDK::REST::SDKError.new error
+        ensure
+          file.close unless file.nil?
+        end
+        { file: file, save_path: save_path }
+      end
+
+      ##
+      # Set up and cache a Net::HTTP object to use when making requests.
+      def set_up_connection # :doc:
+        uri                = URI.parse(@config.host)
+        @http              = Net::HTTP.new(uri.host, uri.port, p_user = @config.proxy_user, p_pass =  @config.proxy_pass)
+        @http.use_ssl      = true
+        @http.verify_mode  = OpenSSL::SSL::VERIFY_NONE
+        @http.use_ssl      = @config.use_ssl
+        if @config.ssl_verify_peer
+          @http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+          @http.ca_file     = @config.ssl_ca_file
+        else
+          @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        end
+        @http.open_timeout = @config.timeout
+        @http.read_timeout = @config.timeout
+      end
+
+      ##
+      # Send an HTTP request using the cached <tt>@http</tt> object and
+      # return the JSON response body parsed into a hash. Also save the raw
+      # Net::HTTP::Request and Net::HTTP::Response objects as
+      # <tt>@last_request</tt> and <tt>@last_response</tt> to allow for
+      # inspection later.
+      def connect_and_send(request, is_file = false ) # :doc:
+        @last_request = request
+        retries_left = @config.retry_limit
+        begin
+          response = @http.request request
+          @last_response = response
+          if response.kind_of? Net::HTTPServerError
+            raise BulutfonSDK::REST::ServerError
+          end
+        rescue
+          raise if request.class == Net::HTTP::Post
+          if retries_left > 0 then retries_left -= 1; retry else raise end
+        end
+        if response.body and !response.body.empty?
+          if is_file
+            object = response.body
+          else
+            object = MultiJson.load response.body
+          end
+        elsif response.kind_of? Net::HTTPBadRequest
+          object = { message: 'Bad request', code: 400 }
+        end
+
+        if response.kind_of? Net::HTTPClientError
+          raise BulutfonSDK::REST::RequestError.new object['error'], object['code']
+        end
+        object
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/bulutfon.rb

@@ -0,0 +1,61 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class Bulutfon < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+      end
+
+      def details
+        prepare_request( 'get', 'me')
+      end
+
+      def messages
+        BulutfonSDK::REST::Message.new(@token)
+      end
+
+      def message_titles
+        BulutfonSDK::REST::MessageTitle.new(@token)
+      end
+
+      def extensions
+        BulutfonSDK::REST::Extension.new(@token)
+      end
+
+      def dids
+        BulutfonSDK::REST::Did.new(@token)
+      end
+
+      def groups
+        BulutfonSDK::REST::Group.new(@token)
+      end
+
+      def cdrs
+        BulutfonSDK::REST::Cdr.new(@token)
+      end
+
+      def call_records
+        BulutfonSDK::REST::CallRecord.new(@token)
+      end
+
+      def incoming_faxes
+        BulutfonSDK::REST::IncomingFax.new(@token)
+      end
+
+      def outgoing_faxes
+        BulutfonSDK::REST::OutgoingFax.new(@token)
+      end
+
+      def announcements
+        BulutfonSDK::REST::Announcement.new(@token)
+      end
+
+      def automatic_calls
+        BulutfonSDK::REST::AutomaticCall.new(@token)
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/call_record.rb

@@ -0,0 +1,23 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class CallRecord < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'call-records'
+      end
+
+      def get( uuid )
+        uri = prepare_uri("#{@resource}/#{uuid}")
+        { download_path: uri.to_s }
+      end
+
+      def save( uuid, save_path)
+        save_file( 'get', "#{@resource}/#{uuid}", save_path)
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/cdr.rb

@@ -0,0 +1,22 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class Cdr < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'cdrs'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource,params)
+      end
+
+      def get( uuid )
+        prepare_request( 'get', "#{@resource}/#{uuid}")
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/did.rb

@@ -0,0 +1,22 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class Did < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'dids'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource,params)
+      end
+
+      def get( id )
+        prepare_request( 'get', "#{@resource}/#{id}")
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/errors.rb

@@ -0,0 +1,24 @@
+module BulutfonSDK
+  module REST
+    class ServerError < StandardError; end
+
+    class RequestError < StandardError
+      attr_reader :code
+
+      def initialize(message, code=nil)
+        super message
+        @code = code
+      end
+    end
+
+    class SDKError < StandardError
+      attr_reader :code
+
+      def initialize(message, code=nil)
+        super message
+        @code = code
+      end
+    end
+
+  end
+end

data/lib/bulutfon_sdk/rest/extension.rb

@@ -0,0 +1,33 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class Extension < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'extensions'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource,params)
+      end
+
+      def get( id )
+        prepare_request( 'get', "#{@resource}/#{id}")
+      end
+
+      def create(params)
+        prepare_request( 'post', @resource, params)
+      end
+
+      def update(id, params)
+        prepare_request( 'put', "#{@resource}/#{id}", params)
+      end
+
+      def delete(id)
+        prepare_request( 'delete', "#{@resource}/#{id}")
+      end
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/group.rb

@@ -0,0 +1,22 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class Group < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'groups'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource,params)
+      end
+
+      def get( id )
+        prepare_request( 'get', "#{@resource}/#{id}")
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/incoming_fax.rb

@@ -0,0 +1,27 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class IncomingFax < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'incoming-faxes'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource, params)
+      end
+
+      def get( uuid )
+        uri = prepare_uri("#{@resource}/#{uuid}")
+        { download_path: uri.to_s }
+      end
+
+      def save( uuid, save_path)
+        save_file( 'get', "#{@resource}/#{uuid}", save_path)
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/message.rb

@@ -0,0 +1,26 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class Message < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'messages'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource,params)
+      end
+
+      def get( id )
+        prepare_request( 'get', "#{@resource}/#{id}")
+      end
+
+      def create(params)
+        prepare_request( 'post', @resource, params)
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/message_title.rb

@@ -0,0 +1,18 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class MessageTitle < BaseRequest
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'message-titles'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource,params)
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/rest/outgoing_fax.rb

@@ -0,0 +1,40 @@
+require 'bulutfon_sdk/rest/base_request'
+
+module BulutfonSDK
+  module REST
+    class OutgoingFax < BaseRequest
+
+      include BulutfonSDK::Util
+
+      def initialize(*args)
+        super(*args)
+        @resource = 'outgoing-faxes'
+      end
+
+      def all( params = {} )
+        prepare_request( 'get', @resource, params)
+      end
+
+      def get( id )
+        prepare_request( 'get', "#{@resource}/#{id}")
+      end
+
+      def create(params)
+        prepare_atachment(params)
+        prepare_request( 'post', @resource, params)
+      end
+
+      private
+
+      def prepare_atachment(params)
+        file          = params[:attachment]
+        basename      = File.basename file
+        type          = file_content_type file
+        content       = File.read(file)
+        base_64_data  = Base64.strict_encode64(content)
+        params[:attachment] = "data:#{type};name:#{basename};base64:#{base_64_data}"
+      end
+
+    end
+  end
+end

data/lib/bulutfon_sdk/util/client_config.rb

@@ -0,0 +1,29 @@
+module BulutfonSDK
+  module Util
+    class ClientConfig
+      DEFAULTS = {
+          host: 'https://api.bulutfon.com',
+          port: 80,
+          use_ssl: true,
+          ssl_verify_peer: false,
+          ssl_ca_file: File.dirname(__FILE__) + '/../../../conf/cacert.pem',
+          timeout: 30,
+          proxy_addr: nil,
+          proxy_port: nil,
+          proxy_user: nil,
+          proxy_pass: nil,
+          retry_limit: 2
+      }
+
+      DEFAULTS.each_key do |attribute|
+        attr_accessor attribute
+      end
+
+      def initialize(opts={})
+        DEFAULTS.each do |attribute, value|
+          send("#{attribute}=".to_sym, opts.fetch(attribute, value))
+        end
+      end
+    end
+  end
+end

data/lib/bulutfon_sdk/util.rb

@@ -0,0 +1,18 @@
+module BulutfonSDK
+  module Util
+    def file_content_type(path)
+      if File.exist? path
+        stdin,stdout,stderr = Open3.popen3(%{file --mime -b #{path}})
+
+        file_err  = stderr.gets
+        file_out  = stdout.gets
+
+        raise BulutfonSDK::REST::SDKError.new "The 'file' command line binary was not found." if file_err
+
+        return file_out.split(';')[0].strip if file_err.nil? && (!file_out.nil? && !file_out.empty?)
+      end
+
+      raise BulutfonSDK::REST::SDKError.new 'File content type not found'
+    end
+  end
+end

data/lib/bulutfon_sdk/version.rb

@@ -0,0 +1,3 @@
+module BulutfonSDK
+  VERSION = '1.1.0'
+end

data/lib/bulutfon_sdk.rb

@@ -0,0 +1,29 @@
+require 'net/http'
+require 'net/https'
+require 'multi_json'
+require 'cgi'
+require 'openssl'
+require 'open3'
+require 'mime/types'
+require 'base64'
+
+require 'bulutfon_sdk/version' unless defined?(BulutfonSDK::VERSION)
+require 'bulutfon_sdk/util'
+require 'bulutfon_sdk/rest/bulutfon'
+require 'bulutfon_sdk/rest/message'
+require 'bulutfon_sdk/rest/did'
+require 'bulutfon_sdk/rest/group'
+require 'bulutfon_sdk/rest/cdr'
+require 'bulutfon_sdk/rest/announcement'
+require 'bulutfon_sdk/rest/automatic_call'
+require 'bulutfon_sdk/rest/call_record'
+require 'bulutfon_sdk/rest/incoming_fax'
+require 'bulutfon_sdk/rest/outgoing_fax'
+require 'bulutfon_sdk/rest/extension'
+require 'bulutfon_sdk/rest/message_title'
+require 'bulutfon_sdk/util/client_config'
+require 'bulutfon_sdk/rest/errors'
+
+module BulutfonSDK
+  # Your code goes here...
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: bulutfon_sdk
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- Ismail Akbudak
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-12-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Bulutfon API SDK for ruby & ruby on rails.
+email:
+- ismail.akbudak@lab2023.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- LICENSE.md
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bulutfon_sdk.gemspec
+- conf/cacert.pem
+- examples/examples.rb
+- examples/pdf-sample.pdf
+- examples/test.wav
+- lib/bulutfon_sdk.rb
+- lib/bulutfon_sdk/rest/announcement.rb
+- lib/bulutfon_sdk/rest/automatic_call.rb
+- lib/bulutfon_sdk/rest/base_request.rb
+- lib/bulutfon_sdk/rest/bulutfon.rb
+- lib/bulutfon_sdk/rest/call_record.rb
+- lib/bulutfon_sdk/rest/cdr.rb
+- lib/bulutfon_sdk/rest/did.rb
+- lib/bulutfon_sdk/rest/errors.rb
+- lib/bulutfon_sdk/rest/extension.rb
+- lib/bulutfon_sdk/rest/group.rb
+- lib/bulutfon_sdk/rest/incoming_fax.rb
+- lib/bulutfon_sdk/rest/message.rb
+- lib/bulutfon_sdk/rest/message_title.rb
+- lib/bulutfon_sdk/rest/outgoing_fax.rb
+- lib/bulutfon_sdk/util.rb
+- lib/bulutfon_sdk/util/client_config.rb
+- lib/bulutfon_sdk/version.rb
+homepage: https://github.com/bulutfon/ruby-sdk
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Bulutfon Ruby SDK.
+test_files: []