infobipapi 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5408b6cf03a955f7d2b6ccff2c966f35f46a27cb
+  data.tar.gz: 3c2ccc52b0abf714eaae7a5f6cacf34798503374
+SHA512:
+  metadata.gz: 633f8626eee9419a045246575fa143a9ec76eff7d256b0f1e972685be4f5ba5a19f5165cfb00ac1c1f2b554324617641a62bbd99e1dbd2f2a1f27c79a8851e8b
+  data.tar.gz: 46ba2eb544776043b0c636c801ae47e9025c1ac65dd6a74f30a82fab603902513f750db2ec4589ab424fd017ce019ac0eaf069e837bd9a5da3657676d85ca4bf

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+pkg
+*.iml
+*.ipr
+*.iws
+.idea
+test-numbers.txt
+vendor/bundle

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [2012] [Infobip]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,103 @@
+InfobipApi ruby client
+============================
+
+Basic messaging example
+-----------------------
+
+First initialize the messaging client using your username and password:
+
+    sms_connector = InfobipApi::SmsClient.new(username, password)
+
+
+An exception will be thrown if your username and/or password are incorrect.
+
+Prepare the message:
+
+    sms = InfobipApi::SMSRequest.new
+    sms.sender_address = '38598123456'
+    sms.address = destination_address
+    sms.message = 'Test message'
+    sms.callback_data = 'Any string'
+
+
+Send the message:
+
+    result = sms_connector.send_sms(sms)
+
+    # Store the client correlator to be able to query for the delivery status later:
+    client_correlator = result.client_correlator
+
+
+Later you can query for the delivery status of the message:
+
+    delivery_status = sms_connector.query_delivery_status(client_correlator)
+
+
+Possible statuses are: **DeliveredToTerminal**, **DeliveryUncertain**, **DeliveryImpossible**, **MessageWaiting** and **DeliveredToNetwork**.
+
+Messaging with notification push example
+-----------------------
+
+Same as with the standard messaging example, but when preparing your message:
+
+    sms = InfobipApi::SMSRequest.new
+    sms.sender_address = '38598123456'
+    sms.address = '38598123456'
+    sms.message = 'Test message'
+    sms.callback_data = 'Any string'
+    sms.notify_url = "http://#{public_ip_address}:#{port}"
+
+
+When the delivery notification is pushed to your server as a HTTP POST request, you must process the body of the message with the following code:
+
+    delivery_info = InfobipApi::SmsClient.unserialize_delivery_status(body)
+
+
+Sending message with special characters example
+-----------------------
+
+If you want to send message with special characters, this is how you prepare your message:
+
+	#Create Language object
+	language = InfobipApi::Language.new
+
+	#set specific language code
+	language.language_code = 'TR'
+
+	#use single shift table for specific language ('false' or 'true')
+	language.use_single_shift = true
+
+	#use locking shift table for specific language ('false' or 'true')
+	language.use_locking_shift = false
+
+	sms = InfobipApi::SMSRequest.new
+	sms.sender_address = '38598123456'
+	sms.address = destination_address
+	sms.message = 'Some text in Turkish'
+	sms.callback_data = 'Any string'
+	sms.language = language
+
+Currently supported languages (with their language codes) are: `Spanish - "SP"`, `Portuguese - "PT"`, `Turkish - "TR"`.
+
+
+Testing Library
+---------------
+
+To test the library, run :
+
+    API_USERNAME="Toto" API_PASSWORD="Titi" bundle exec ruby test/test.rb
+
+API_USERNAME and API_PASSWORD must be valid account credentials for the Infobip API. For more information, go to https://dev.infobip.com/docs/getting-started
+
+You must also provide a text file containing sms numbers where you can receive messages (one by line) :
+
+    echo "33123456789" > test-numbers.txt
+    echo "33012345678" >> test-numbers.txt
+
+These numbers must be in international format (used by the API).
+
+
+License
+-------
+
+This library is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)

data/infobipapi.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'infobipapi/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "infobipapi"
+  spec.version       = InfobipApi::VERSION
+  spec.date          = "2017-02-08"
+  spec.authors       = ["Roland Laurès"]
+  spec.email         = [ "roland.laures@netcat.io"]
+  spec.description   = %q{InfobipApi}
+  spec.summary       = %q{InfobipApi Ruby client library}
+  spec.homepage      = "https://github.com/Gnuside/infobipapi"
+  spec.license       = "Apache"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake", "~> 12"
+  spec.add_development_dependency "minitest", "~> 5"
+  spec.add_development_dependency "pry-coolline", "~> 0"
+  spec.add_development_dependency "pry", "~> 0"
+end

data/lib/infobipapi.rb

@@ -0,0 +1,10 @@
+# vim: set sw=4 ts=4 et :
+
+require "infobipapi/version"
+require "infobipapi/utils"
+require "infobipapi/objects"
+require "infobipapi/models"
+require "infobipapi/client"
+
+module InfobipApi
+end

data/lib/infobipapi/client.rb

@@ -0,0 +1,394 @@
+# vim: set sw=4 ts=4 et :
+
+#require 'pry'
+require 'net/http'
+require 'net/https'
+require "base64"
+require 'json'
+require 'pry'
+
+require_relative 'objects'
+require_relative 'models'
+
+module InfobipApi
+
+    class InfobipApiClient
+
+        def initialize(username, password, base_url=nil)
+            @username = username
+            @password = password
+            if base_url
+                @base_url = base_url
+            else
+                @base_url = 'https://api.infobip.com/'
+            end
+
+            if @base_url[-1, 1] != '/'
+                @base_url += '/'
+            end
+
+            @infobipapi_authentication = nil
+
+            login()
+        end
+
+
+        def login()
+            params = {
+              'username' => @username,
+              'password' => @password,
+            }
+
+            is_success, result = execute_POST('auth/1/session', params)
+
+            filled = fill_infobipapi_authentication(result, is_success)
+            #puts ""
+            #puts "login: #{filled.inspect}"
+            return filled
+        end
+
+        def get_or_create_client_correlator(client_correlator=nil)
+            if client_correlator
+                return client_correlator
+            end
+
+            return Utils.get_random_alphanumeric_string()
+        end
+
+        def prepare_headers(request)
+            request["User-Agent"] = "InfobipApi-#{InfobipApi::VERSION}"
+            request["Content-Type"] = "application/json"
+            if @infobipapi_authentication and @infobipapi_authentication.token
+                request['Authorization'] = "IBSSO #{@infobipapi_authentication.token}"
+            else
+                auth_string = Base64.encode64("#{@username}:#{@password}").strip
+                request['Authorization'] = "Basic #{auth_string}"
+            end
+        end
+
+        def is_success(response)
+            http_code = response.code.to_i
+            is_success = 200 <= http_code && http_code < 300
+
+            is_success
+        end
+
+        def urlencode(params)
+            if Utils.empty(params)
+                return ''
+            end
+            if params.instance_of? String
+                return URI.encode(params)
+            end
+            result = ''
+            params.each_key do |key|
+                if ! Utils.empty(result)
+                    result += '&'
+                end
+                result += URI.encode(key.to_s) + '=' + URI.encode(params[key].to_s)
+            end
+
+            return result
+        end
+
+        def execute_GET(url, params=nil)
+            execute_request('GET', url, params)
+        end
+
+        def execute_POST(url, params=nil)
+            execute_request('POST', url, params)
+        end
+
+        def execute_request(http_method, url, params)
+            rest_url = get_rest_url(url)
+            uri = URI(URI.encode(rest_url))
+
+            if Utils.empty(params)
+                params = {}
+            end
+
+            if http_method == 'GET'
+                request = Net::HTTP::Get.new("#{uri.request_uri}?#{urlencode(params)}")
+            elsif http_method == 'POST'
+              request = Net::HTTP::Post.new(uri.request_uri)
+              #binding.pry if params.has_key?(:binary)
+              request.body = params.to_json
+            end
+
+            http = Net::HTTP.new(uri.host, uri.port)
+
+            use_ssl = rest_url.start_with? "https"
+            if use_ssl
+                http.use_ssl = true
+                http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+            end
+
+            prepare_headers(request)
+            response = http.request(request)
+
+            #puts ""
+            #puts "response: #{response.inspect}"
+            #puts "body: #{response.body}"
+            #puts ""
+
+            return is_success(response), response.body
+        end
+
+        def get_rest_url(rest_path)
+            if not rest_path
+                return @base_url
+            end
+
+            if rest_path[0, 1] == '/'
+                return @base_url + rest_path[1, rest_path.length]
+            end
+
+            @base_url + rest_path
+        end
+
+        def fill_infobipapi_authentication(json, is_success)
+            @infobipapi_authentication = convert_from_json(AuthenticationAnswer, json, !is_success)
+
+
+            @infobipapi_authentication = nil if @infobipapi_authentication.token.nil? \
+              || @infobipapi_authentication.token.length == 0
+
+            @infobipapi_authentication
+        end
+
+        def convert_from_json(classs, json, is_error)
+            Conversions.from_json(classs, json, is_error)
+        end
+
+    end
+
+    class SmsClient < InfobipApiClient
+
+        def initialize(username, password, base_url=nil)
+            super(username, password, base_url)
+        end
+
+        # send single sms message to one or many destination addresses.
+        # cf: https://dev.infobip.com/docs/send-single-sms
+        # param fields names:
+        # - from: string
+        #   Represents sender ID and it can be alphanumeric or numeric. Alphanumeric sender ID length should be between 3 and 11 characters (Example: CompanyName). Numeric sender ID length should be between 3 and 14 characters.
+        # - to: `required` array of strings
+        #   Array of message destination addresses. If you want to send a message to one destination, a single String is supported instead of an Array. Destination addresses must be in international format (Example: 41793026727).
+        # - text: string
+        #   Text of the message that will be sent.
+        #   (Developper comment: chars must be 7bits or comportment is not predictable on the receiving phones)
+        #
+        def single_text_sms(sms)
+            params = {
+              :from => sms.from,
+              :to => sms.to,
+              :text => sms.text
+            }
+            is_success, result = execute_POST( "/sms/1/text/single", params )
+
+            convert_from_json(SimpleSMSAnswer, result, !is_success)
+        end
+
+        # send multiple sms message to one or many destination addresses.
+        # cf: https://dev.infobip.com/docs/send-multiple-sms
+        # param fields names, array of :
+        # - from: string
+        #   Represents sender ID and it can be alphanumeric or numeric. Alphanumeric sender ID length should be between 3 and 11 characters (Example: CompanyName). Numeric sender ID length should be between 3 and 14 characters.
+        # - to: `required` array of strings
+        #   Array of message destination addresses. If you want to send a message to one destination, a single String is supported instead of an Array. Destination addresses must be in international format (Example: 41793026727).
+        # - text: string
+        #   Text of the message that will be sent.
+        #   (Developper comment: chars must be 7bits or comportment is not predictable on the receiving phones)
+        #
+        def multiple_text_sms(smss)
+            params = {
+              :messages => []
+            }
+            smss.each { |sms|
+              params[:messages].push({
+                :from => sms.from,
+                :to => sms.to,
+                :text => sms.text
+              })
+            }
+
+            is_success, result = execute_POST( "/sms/1/text/multi", params )
+
+            convert_from_json(SimpleSMSAnswer, result, !is_success)
+        end
+
+        # .codepoints.map { |c| "%02x %02x" % [c / 256,c % 256] }.join " "
+
+        def compute_sms_usage(str)
+          # single SMS length per SMS (GSM7): 160
+          # multiple SMS length per SMS (GSM7): 153
+          # single SMS length per SMS (UCS-2): 70
+          # multiple SMS length per SMS (UCS-2): 67
+          sms_lengths = Hash.new
+          # ! has_unicode_char
+          sms_lengths[false] = Hash.new
+          sms_lengths[false][true] = 153 # need_more_than_one_sms
+          sms_lengths[false][false] = 160 # ! need_more_than_one_sms
+          # has_unicode_char
+          sms_lengths[true] = Hash.new
+          sms_lengths[true][true] = 67 # need_more_than_one_sms
+          sms_lengths[true][false] = 70 # ! need_more_than_one_sms
+          {
+              :single_gsm7 => 160,
+              :multi_gsm7 => 153,
+              :single_ucs2 => 70,
+              :multi_ucs2 => 67
+            }
+            has_unicode_char = false
+            need_more_than_one_sms = false
+            str.each_char { |c|
+              if not Utils.in_gsm7_set?(c) then
+                has_unicode_char = true
+                break
+              end
+            }
+            if has_unicode_char then
+              need_more_than_one_sms = str.length > 70
+              format = :unicode
+            else
+              need_more_than_one_sms = str.length > 160
+              format = :gsm7
+            end
+            return {
+              :format => format,
+              :length => str.length,
+              :length_by_sms => sms_lengths[has_unicode_char][need_more_than_one_sms],
+              :number_of_sms => (str.length.to_f / sms_lengths[has_unicode_char][need_more_than_one_sms].to_f).ceil
+            }
+        end
+
+        # send single sms message to one or many destination addresses.
+        # TEXT in UTF-8 format if all chars are gsm7 encoding compatible then
+        # the SMS is sent with gsm7 encoding. Else it will be sent in Unicode
+        # binary format.
+        # cf: https://dev.infobip.com/docs/send-single-sms
+        # cf: https://dev.infobip.com/docs/send-single-binary-sms
+        # param fields names:
+        # - from: string
+        #   Represents sender ID and it can be alphanumeric or numeric. Alphanumeric sender ID length should be between 3 and 11 characters (Example: CompanyName). Numeric sender ID length should be between 3 and 14 characters.
+        # - to: `required` array of strings
+        #   Array of message destination addresses. If you want to send a message to one destination, a single String is supported instead of an Array. Destination addresses must be in international format (Example: 41793026727).
+        # - text: string utf-8 encoded
+        #   Text of the message that will be sent.
+        #   (Developper comment: chars must be 7bits or comportment is not predictable on the receiving phones)
+        #
+        def single_utf8_sms(sms)
+          usage = self.compute_sms_usage(sms.text)
+          if usage[:format] == :gsm7 then
+            params = {
+              :from => sms.from,
+              :to => sms.to,
+              :text => sms.text
+            }
+            uri = "/sms/1/text/single"
+          else
+            text_array = sms.text.force_encoding('utf-8').codepoints.map { |c| sprintf('%02x', c) }
+            params = {
+              :from => sms.from,
+              :to => sms.to,
+              :binary => {
+                :hex => text_array.join(' '),
+                :dataCoding => 8,
+                :esmClass => 0
+              }
+            }
+            uri = "/sms/1/binary/single"
+          end
+          is_success, result = execute_POST(uri , params )
+          convert_from_json(SimpleSMSAnswer, result, !is_success)
+        end
+
+        # send multiple sms message to one or many destination addresses.
+        # TEXT in UTF-8 format if all chars are gsm7 encoding compatible then
+        # the SMS is sent with gsm7 encoding. Else it will be sent in Unicode
+        # binary format.
+        # cf: https://dev.infobip.com/docs/send-multiple-sms
+        # param fields names, array of :
+        # - from: string
+        #   Represents sender ID and it can be alphanumeric or numeric. Alphanumeric sender ID length should be between 3 and 11 characters (Example: CompanyName). Numeric sender ID length should be between 3 and 14 characters.
+        # - to: `required` array of strings
+        #   Array of message destination addresses. If you want to send a message to one destination, a single String is supported instead of an Array. Destination addresses must be in international format (Example: 41793026727).
+        # - text: string utf-8 encoded
+        #   Text of the message that will be sent.
+        #   (Developper comment: chars must be 7bits or comportment is not predictable on the receiving phones)
+        #
+        # Return an array of 2 results :
+        #   one for a /sms/1/text/multi query (nil if none is sent as text)
+        #   second one for a /sms/1/binary/multi query (nil if none is sent as binary)
+        def multiple_utf8_sms(smss)
+            params = {
+              :text => {
+                :uri => "/sms/1/text/multi",
+                :messages => []
+              },
+              :binary => {
+                :uri => "/sms/1/binary/multi",
+                :messages => []
+              }
+            }
+            smss.each { |sms|
+              usage = self.compute_sms_usage(sms.text)
+              if usage[:format] == :gsm7 then
+                params[:text][:messages].push({
+                  :from => sms.from,
+                  :to => sms.to,
+                  :text => sms.text
+                })
+              else
+                text_array = sms.text.force_encoding('utf-8').codepoints.map { |c| sprintf('%02x', c) }
+                params[:binary][:messages].push({
+                  :from => sms.from,
+                  :to => sms.to,
+                  :binary => {
+                    :hex => text_array.join(' '),
+                    :dataCoding => 8,
+                    :esmClass => 0
+                  }
+                })
+              end
+            }
+
+            results = []
+            if params[:text][:messages].length > 0 then
+              is_success, result = execute_POST( params[:text][:uri] , params[:text][:messages] )
+              results.push(convert_from_json(SimpleSMSAnswer, result, !is_success))
+            else
+              results.push(nil)
+            end
+
+            if params[:binary][:messages].length > 0 then
+              is_success, result = execute_POST( params[:binary][:uri] , params[:binary][:messages] )
+              results.push(convert_from_json(SimpleSMSAnswer, result, !is_success))
+            else
+              results.push(nil)
+            end
+            return results
+        end
+
+        # Get delivery reports
+        # cf: https://dev.infobip.com/docs/delivery-reports
+        # parm fields names :
+        # - bulkId: string
+        #   The ID that uniquely identifies the request. Bulk ID will be received only when you send a message to more than one destination address.
+        # - messageId: string
+        # The ID that uniquely identifies the message sent.
+        # - limit: string
+        #   Number of returned delivery reports. Default value is 50. Max number per request is 10000.
+        def delivery_reports(params)
+            req = {} # safety parameters treatment
+            req[:bulkId] = params[:bulkId] if params.has_key?:bulkId
+            req[:messageId] = params[:messageId] if params.has_key?:messageId
+            req[:limit] = params[:limit] if params.has_key?:limit
+            is_success, result = execute_GET("/sms/1/reports", req)
+            convert_from_json(DeliveryReportList,result, !is_success)
+        end
+    end
+
+end
+