twilio-ruby 4.6.1 → 6.9.0

data/lib/twilio-ruby/rest/ip_messaging/v2.rb

@@ -0,0 +1,64 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Ip_messaging
+#    This is the public Twilio REST API.
+#
+#    NOTE: This class is auto generated by OpenAPI Generator.
+#    https://openapi-generator.tech
+#    Do not edit the class manually.
+#
+
+module Twilio
+    module REST
+        class IpMessaging
+            class V2 < Version
+                ##
+                # Initialize the V2 version of IpMessaging
+                def initialize(domain)
+                    super
+                    @version = 'v2'
+                    @credentials = nil
+                    @services = nil
+                end
+
+                ##
+                # @param [String] sid 
+                # @return [Twilio::REST::IpMessaging::V2::CredentialContext] if sid was passed.
+                # @return [Twilio::REST::IpMessaging::V2::CredentialList]
+                def credentials(sid=:unset)
+                    if sid.nil?
+                        raise ArgumentError, 'sid cannot be nil'
+                    end
+                    if sid == :unset
+                        @credentials ||= CredentialList.new self
+                    else
+                        CredentialContext.new(self, sid)
+                    end
+                end
+                ##
+                # @param [String] sid 
+                # @return [Twilio::REST::IpMessaging::V2::ServiceContext] if sid was passed.
+                # @return [Twilio::REST::IpMessaging::V2::ServiceList]
+                def services(sid=:unset)
+                    if sid.nil?
+                        raise ArgumentError, 'sid cannot be nil'
+                    end
+                    if sid == :unset
+                        @services ||= ServiceList.new self
+                    else
+                        ServiceContext.new(self, sid)
+                    end
+                end
+                ##
+                # Provide a user friendly representation
+                def to_s
+                    '<Twilio::REST::IpMessaging::V2>';
+                end
+            end
+        end
+    end
+end

data/lib/twilio-ruby/rest/ip_messaging.rb

@@ -0,0 +1,23 @@
+module Twilio
+  module REST
+    class IpMessaging < IpMessagingBase
+      ##
+      # @param [String] sid The sid
+      # @return [Twilio::REST::Ip_messaging::V2::CredentialInstance] if sid was passed.
+      # @return [Twilio::REST::Ip_messaging::V2::CredentialList]
+      def credentials(sid=:unset)
+        warn "credentials is deprecated. Use v2.credentials instead."
+        self.v2.credentials(sid)
+      end
+
+      ##
+      # @param [String] sid The sid
+      # @return [Twilio::REST::Ip_messaging::V2::ServiceInstance] if sid was passed.
+      # @return [Twilio::REST::Ip_messaging::V2::ServiceList]
+      def services(sid=:unset)
+        warn "services is deprecated. Use v2.services instead."
+        self.v2.services(sid)
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/ip_messaging_base.rb

@@ -0,0 +1,43 @@
+##
+ # This code was generated by
+ # ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+ #  |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+ #  |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+ #
+ # NOTE: This class is auto generated by OpenAPI Generator.
+ # https://openapi-generator.tech
+ # Do not edit the class manually.
+# frozen_string_literal: true
+module Twilio
+  module REST
+    class IpMessagingBase < Domain
+      ##
+      # Initialize ipMessaging domain
+      #
+      # @param twilio - The twilio client
+      #
+      def initialize(twilio)
+        super(twilio)
+        @base_url =  "https://ip-messaging.twilio.com"
+        @host = "ip-messaging.twilio.com"
+        @port = 443
+        @v1 = nil
+        @v2 = nil
+      end
+
+      def v1
+        @v1 ||= IpMessaging::V1.new self
+      end
+
+      def v2
+        @v2 ||= IpMessaging::V2.new self
+      end
+
+      ##
+      # Provide a user friendly representation
+      def to_s
+        '<Twilio::REST::IpMessaging>';
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/lookups/v1/phone_number.rb

@@ -0,0 +1,251 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Lookups
+#    This is the public Twilio REST API.
+#
+#    NOTE: This class is auto generated by OpenAPI Generator.
+#    https://openapi-generator.tech
+#    Do not edit the class manually.
+#
+
+
+module Twilio
+    module REST
+        class Lookups < LookupsBase
+            class V1 < Version
+                class PhoneNumberList < ListResource
+                    ##
+                    # Initialize the PhoneNumberList
+                    # @param [Version] version Version that contains the resource
+                    # @return [PhoneNumberList] PhoneNumberList
+                    def initialize(version)
+                        super(version)
+                        # Path Solution
+                        @solution = {  }
+                        
+                        
+                    end
+                
+
+
+                    # Provide a user friendly representation
+                    def to_s
+                        '#<Twilio.Lookups.V1.PhoneNumberList>'
+                    end
+                end
+
+
+                class PhoneNumberContext < InstanceContext
+                    ##
+                    # Initialize the PhoneNumberContext
+                    # @param [Version] version Version that contains the resource
+                    # @param [String] phone_number The phone number to lookup in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
+                    # @return [PhoneNumberContext] PhoneNumberContext
+                    def initialize(version, phone_number)
+                        super(version)
+
+                        # Path Solution
+                        @solution = { phone_number: phone_number,  }
+                        @uri = "/PhoneNumbers/#{CGI.escape(@solution[:phone_number]).gsub("+", "%20")}"
+
+                        
+                    end
+                    ##
+                    # Fetch the PhoneNumberInstance
+                    # @param [String] country_code The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the phone number to fetch. This is used to specify the country when the phone number is provided in a national format.
+                    # @param [Array[String]] type The type of information to return. Can be: `carrier` or `caller-name`. The default is null.  Carrier information costs $0.005 per phone number looked up.  Caller Name information is currently available only in the US and costs $0.01 per phone number looked up.  To retrieve both types on information, specify this parameter twice; once with `carrier` and once with `caller-name` as the value.
+                    # @param [Array[String]] add_ons The `unique_name` of an Add-on you would like to invoke. Can be the `unique_name` of an Add-on that is installed on your account. You can specify multiple instances of this parameter to invoke multiple Add-ons. For more information about  Add-ons, see the [Add-ons documentation](https://www.twilio.com/docs/add-ons).
+                    # @param [Hash] add_ons_data Data specific to the add-on you would like to invoke. The content and format of this value depends on the add-on.
+                    # @return [PhoneNumberInstance] Fetched PhoneNumberInstance
+                    def fetch(
+                        country_code: :unset, 
+                        type: :unset, 
+                        add_ons: :unset, 
+                        add_ons_data: :unset
+                    )
+
+                        params = Twilio::Values.of({
+                            'CountryCode' => country_code,
+                            'Type' => Twilio.serialize_list(type) { |e| e },
+                            'AddOns' => Twilio.serialize_list(add_ons) { |e| e },
+                        })
+                        params.merge!(Twilio.prefixed_collapsible_map(add_ons_data, 'AddOns'))
+                        payload = @version.fetch('GET', @uri, params: params)
+                        PhoneNumberInstance.new(
+                            @version,
+                            payload,
+                            phone_number: @solution[:phone_number],
+                        )
+                    end
+
+
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        context = @solution.map{|k, v| "#{k}: #{v}"}.join(',')
+                        "#<Twilio.Lookups.V1.PhoneNumberContext #{context}>"
+                    end
+
+                    ##
+                    # Provide a detailed, user friendly representation
+                    def inspect
+                        context = @solution.map{|k, v| "#{k}: #{v}"}.join(',')
+                        "#<Twilio.Lookups.V1.PhoneNumberContext #{context}>"
+                    end
+                end
+
+                class PhoneNumberPage < Page
+                    ##
+                    # Initialize the PhoneNumberPage
+                    # @param [Version] version Version that contains the resource
+                    # @param [Response] response Response from the API
+                    # @param [Hash] solution Path solution for the resource
+                    # @return [PhoneNumberPage] PhoneNumberPage
+                    def initialize(version, response, solution)
+                        super(version, response)
+
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    ##
+                    # Build an instance of PhoneNumberInstance
+                    # @param [Hash] payload Payload response from the API
+                    # @return [PhoneNumberInstance] PhoneNumberInstance
+                    def get_instance(payload)
+                        PhoneNumberInstance.new(@version, payload)
+                    end
+
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        '<Twilio.Lookups.V1.PhoneNumberPage>'
+                    end
+                end
+                class PhoneNumberInstance < InstanceResource
+                    ##
+                    # Initialize the PhoneNumberInstance
+                    # @param [Version] version Version that contains the resource
+                    # @param [Hash] payload payload that contains response from Twilio
+                    # @param [String] account_sid The SID of the
+                    #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this PhoneNumber
+                    #   resource.
+                    # @param [String] sid The SID of the Call resource to fetch.
+                    # @return [PhoneNumberInstance] PhoneNumberInstance
+                    def initialize(version, payload , phone_number: nil)
+                        super(version)
+                        
+                        # Marshaled Properties
+                        @properties = { 
+                            'caller_name' => payload['caller_name'],
+                            'country_code' => payload['country_code'],
+                            'phone_number' => payload['phone_number'],
+                            'national_format' => payload['national_format'],
+                            'carrier' => payload['carrier'],
+                            'add_ons' => payload['add_ons'],
+                            'url' => payload['url'],
+                        }
+
+                        # Context
+                        @instance_context = nil
+                        @params = { 'phone_number' => phone_number  || @properties['phone_number']  , }
+                    end
+
+                    ##
+                    # Generate an instance context for the instance, the context is capable of
+                    # performing various actions.  All instance actions are proxied to the context
+                    # @return [PhoneNumberContext] CallContext for this CallInstance
+                    def context
+                        unless @instance_context
+                            @instance_context = PhoneNumberContext.new(@version , @params['phone_number'])
+                        end
+                        @instance_context
+                    end
+                    
+                    ##
+                    # @return [Hash] The name of the phone number's owner. If `null`, that information was not available.
+                    def caller_name
+                        @properties['caller_name']
+                    end
+                    
+                    ##
+                    # @return [String] The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) for the phone number.
+                    def country_code
+                        @properties['country_code']
+                    end
+                    
+                    ##
+                    # @return [String] The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
+                    def phone_number
+                        @properties['phone_number']
+                    end
+                    
+                    ##
+                    # @return [String] The phone number, in national format.
+                    def national_format
+                        @properties['national_format']
+                    end
+                    
+                    ##
+                    # @return [Hash] The telecom company that provides the phone number.
+                    def carrier
+                        @properties['carrier']
+                    end
+                    
+                    ##
+                    # @return [Hash] A JSON string with the results of the Add-ons you specified in the `add_ons` parameters. For the format of the object, see [Using Add-ons](https://www.twilio.com/docs/add-ons).
+                    def add_ons
+                        @properties['add_ons']
+                    end
+                    
+                    ##
+                    # @return [String] The absolute URL of the resource.
+                    def url
+                        @properties['url']
+                    end
+                    
+                    ##
+                    # Fetch the PhoneNumberInstance
+                    # @param [String] country_code The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the phone number to fetch. This is used to specify the country when the phone number is provided in a national format.
+                    # @param [Array[String]] type The type of information to return. Can be: `carrier` or `caller-name`. The default is null.  Carrier information costs $0.005 per phone number looked up.  Caller Name information is currently available only in the US and costs $0.01 per phone number looked up.  To retrieve both types on information, specify this parameter twice; once with `carrier` and once with `caller-name` as the value.
+                    # @param [Array[String]] add_ons The `unique_name` of an Add-on you would like to invoke. Can be the `unique_name` of an Add-on that is installed on your account. You can specify multiple instances of this parameter to invoke multiple Add-ons. For more information about  Add-ons, see the [Add-ons documentation](https://www.twilio.com/docs/add-ons).
+                    # @param [Hash] add_ons_data Data specific to the add-on you would like to invoke. The content and format of this value depends on the add-on.
+                    # @return [PhoneNumberInstance] Fetched PhoneNumberInstance
+                    def fetch(
+                        country_code: :unset, 
+                        type: :unset, 
+                        add_ons: :unset, 
+                        add_ons_data: :unset
+                    )
+
+                        context.fetch(
+                            country_code: country_code, 
+                            type: type, 
+                            add_ons: add_ons, 
+                            add_ons_data: add_ons_data, 
+                        )
+                    end
+
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+                        "<Twilio.Lookups.V1.PhoneNumberInstance #{values}>"
+                    end
+
+                    ##
+                    # Provide a detailed, user friendly representation
+                    def inspect
+                        values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                        "<Twilio.Lookups.V1.PhoneNumberInstance #{values}>"
+                    end
+                end
+
+            end
+        end
+    end
+end

data/lib/twilio-ruby/rest/lookups/v1.rb

@@ -0,0 +1,49 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Lookups
+#    This is the public Twilio REST API.
+#
+#    NOTE: This class is auto generated by OpenAPI Generator.
+#    https://openapi-generator.tech
+#    Do not edit the class manually.
+#
+
+module Twilio
+    module REST
+        class Lookups
+            class V1 < Version
+                ##
+                # Initialize the V1 version of Lookups
+                def initialize(domain)
+                    super
+                    @version = 'v1'
+                    @phone_numbers = nil
+                end
+
+                ##
+                # @param [String] phone_number The phone number to lookup in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
+                # @return [Twilio::REST::Lookups::V1::PhoneNumberContext] if phoneNumber was passed.
+                # @return [Twilio::REST::Lookups::V1::PhoneNumberList]
+                def phone_numbers(phone_number=:unset)
+                    if phone_number.nil?
+                        raise ArgumentError, 'phone_number cannot be nil'
+                    end
+                    if phone_number == :unset
+                        @phone_numbers ||= PhoneNumberList.new self
+                    else
+                        PhoneNumberContext.new(self, phone_number)
+                    end
+                end
+                ##
+                # Provide a user friendly representation
+                def to_s
+                    '<Twilio::REST::Lookups::V1>';
+                end
+            end
+        end
+    end
+end