=begin #Svix API #Welcome to the Svix API documentation! Useful links: [Homepage](https://www.svix.com) | [Support email](mailto:support+docs@svix.com) | [Blog](https://www.svix.com/blog/) | [Slack Community](https://www.svix.com/slack/) # Introduction This is the reference documentation and schemas for the [Svix webhook service](https://www.svix.com) API. For tutorials and other documentation please refer to [the documentation](https://docs.svix.com). ## Main concepts In Svix you have four important entities you will be interacting with: - `messages`: these are the webhooks being sent. They can have contents and a few other properties. - `application`: this is where `messages` are sent to. Usually you want to create one application for each user on your platform. - `endpoint`: endpoints are the URLs messages will be sent to. Each application can have multiple `endpoints` and each message sent to that application will be sent to all of them (unless they are not subscribed to the sent event type). - `event-type`: event types are identifiers denoting the type of the message being sent. Event types are primarily used to decide which events are sent to which endpoint. ## Authentication Get your authentication token (`AUTH_TOKEN`) from the [Svix dashboard](https://dashboard.svix.com) and use it as part of the `Authorization` header as such: `Authorization: Bearer ${AUTH_TOKEN}`. ## Code samples The code samples assume you already have the respective libraries installed and you know how to use them. For the latest information on how to do that, please refer to [the documentation](https://docs.svix.com/). ## Cross-Origin Resource Sharing This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/). And that allows cross-domain communication from the browser. All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site. The version of the OpenAPI document: 1.4 Generated by: https://openapi-generator.tech OpenAPI Generator version: 5.2.0 =end require 'date' require 'time' module Svix class EndpointIn attr_accessor :description attr_accessor :disabled attr_accessor :filter_types attr_accessor :rate_limit # The endpoint's verification secret. If `null` is passed, a secret is automatically generated. attr_accessor :secret # Optional unique identifier for the endpoint attr_accessor :uid attr_accessor :url attr_accessor :version # Attribute mapping from ruby-style variable name to JSON key. def self.attribute_map { :'description' => :'description', :'disabled' => :'disabled', :'filter_types' => :'filterTypes', :'rate_limit' => :'rateLimit', :'secret' => :'secret', :'uid' => :'uid', :'url' => :'url', :'version' => :'version' } end # Returns all the JSON keys this model knows about def self.acceptable_attributes attribute_map.values end # Attribute type mapping. def self.openapi_types { :'description' => :'String', :'disabled' => :'Boolean', :'filter_types' => :'Array', :'rate_limit' => :'Integer', :'secret' => :'String', :'uid' => :'String', :'url' => :'String', :'version' => :'Integer' } end # List of attributes with nullable: true def self.openapi_nullable Set.new([ ]) end # Initializes the object # @param [Hash] attributes Model attributes in the form of hash def initialize(attributes = {}) if (!attributes.is_a?(Hash)) fail ArgumentError, "The input argument (attributes) must be a hash in `Svix::EndpointIn` initialize method" end # check to see if the attribute exists and convert string to symbol for hash key attributes = attributes.each_with_object({}) { |(k, v), h| if (!self.class.attribute_map.key?(k.to_sym)) fail ArgumentError, "`#{k}` is not a valid attribute in `Svix::EndpointIn`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect end h[k.to_sym] = v } if attributes.key?(:'description') self.description = attributes[:'description'] else self.description = '' end if attributes.key?(:'disabled') self.disabled = attributes[:'disabled'] else self.disabled = false end if attributes.key?(:'filter_types') if (value = attributes[:'filter_types']).is_a?(Array) self.filter_types = value end end if attributes.key?(:'rate_limit') self.rate_limit = attributes[:'rate_limit'] end if attributes.key?(:'secret') self.secret = attributes[:'secret'] end if attributes.key?(:'uid') self.uid = attributes[:'uid'] end if attributes.key?(:'url') self.url = attributes[:'url'] end if attributes.key?(:'version') self.version = attributes[:'version'] end end # Show invalid properties with the reasons. Usually used together with valid? # @return Array for valid properties with the reasons def list_invalid_properties invalid_properties = Array.new if !@filter_types.nil? && @filter_types.length < 1 invalid_properties.push('invalid value for "filter_types", number of items must be greater than or equal to 1.') end pattern = Regexp.new(/^whsec_[a-zA-Z0-9+\/]{32}$/) if !@secret.nil? && @secret !~ pattern invalid_properties.push("invalid value for \"secret\", must conform to the pattern #{pattern}.") end if !@uid.nil? && @uid.to_s.length > 256 invalid_properties.push('invalid value for "uid", the character length must be smaller than or equal to 256.') end if !@uid.nil? && @uid.to_s.length < 1 invalid_properties.push('invalid value for "uid", the character length must be great than or equal to 1.') end pattern = Regexp.new(/^[a-zA-Z0-9\-_.]+$/) if !@uid.nil? && @uid !~ pattern invalid_properties.push("invalid value for \"uid\", must conform to the pattern #{pattern}.") end if @url.nil? invalid_properties.push('invalid value for "url", url cannot be nil.') end if @url.to_s.length > 65536 invalid_properties.push('invalid value for "url", the character length must be smaller than or equal to 65536.') end if @url.to_s.length < 1 invalid_properties.push('invalid value for "url", the character length must be great than or equal to 1.') end if @version.nil? invalid_properties.push('invalid value for "version", version cannot be nil.') end invalid_properties end # Check to see if the all the properties in the model are valid # @return true if the model is valid def valid? return false if !@filter_types.nil? && @filter_types.length < 1 return false if !@secret.nil? && @secret !~ Regexp.new(/^whsec_[a-zA-Z0-9+\/]{32}$/) return false if !@uid.nil? && @uid.to_s.length > 256 return false if !@uid.nil? && @uid.to_s.length < 1 return false if !@uid.nil? && @uid !~ Regexp.new(/^[a-zA-Z0-9\-_.]+$/) return false if @url.nil? return false if @url.to_s.length > 65536 return false if @url.to_s.length < 1 return false if @version.nil? true end # Custom attribute writer method with validation # @param [Object] filter_types Value to be assigned def filter_types=(filter_types) if !filter_types.nil? && filter_types.length < 1 fail ArgumentError, 'invalid value for "filter_types", number of items must be greater than or equal to 1.' end @filter_types = filter_types end # Custom attribute writer method with validation # @param [Object] secret Value to be assigned def secret=(secret) pattern = Regexp.new(/^whsec_[a-zA-Z0-9+\/]{32}$/) if !secret.nil? && secret !~ pattern fail ArgumentError, "invalid value for \"secret\", must conform to the pattern #{pattern}." end @secret = secret end # Custom attribute writer method with validation # @param [Object] uid Value to be assigned def uid=(uid) if !uid.nil? && uid.to_s.length > 256 fail ArgumentError, 'invalid value for "uid", the character length must be smaller than or equal to 256.' end if !uid.nil? && uid.to_s.length < 1 fail ArgumentError, 'invalid value for "uid", the character length must be great than or equal to 1.' end pattern = Regexp.new(/^[a-zA-Z0-9\-_.]+$/) if !uid.nil? && uid !~ pattern fail ArgumentError, "invalid value for \"uid\", must conform to the pattern #{pattern}." end @uid = uid end # Custom attribute writer method with validation # @param [Object] url Value to be assigned def url=(url) if url.nil? fail ArgumentError, 'url cannot be nil' end if url.to_s.length > 65536 fail ArgumentError, 'invalid value for "url", the character length must be smaller than or equal to 65536.' end if url.to_s.length < 1 fail ArgumentError, 'invalid value for "url", the character length must be great than or equal to 1.' end @url = url end # Checks equality by comparing each attribute. # @param [Object] Object to be compared def ==(o) return true if self.equal?(o) self.class == o.class && description == o.description && disabled == o.disabled && filter_types == o.filter_types && rate_limit == o.rate_limit && secret == o.secret && uid == o.uid && url == o.url && version == o.version end # @see the `==` method # @param [Object] Object to be compared def eql?(o) self == o end # Calculates hash code according to all attributes. # @return [Integer] Hash code def hash [description, disabled, filter_types, rate_limit, secret, uid, url, version].hash end # Builds the object from hash # @param [Hash] attributes Model attributes in the form of hash # @return [Object] Returns the model itself def self.build_from_hash(attributes) new.build_from_hash(attributes) end # Builds the object from hash # @param [Hash] attributes Model attributes in the form of hash # @return [Object] Returns the model itself def build_from_hash(attributes) return nil unless attributes.is_a?(Hash) self.class.openapi_types.each_pair do |key, type| if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key) self.send("#{key}=", nil) elsif type =~ /\AArray<(.*)>/i # check to ensure the input is an array given that the attribute # is documented as an array but the input is not if attributes[self.class.attribute_map[key]].is_a?(Array) self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) }) end elsif !attributes[self.class.attribute_map[key]].nil? self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]])) end end self end # Deserializes the data based on type # @param string type Data type # @param string value Value to be deserialized # @return [Object] Deserialized data def _deserialize(type, value) case type.to_sym when :Time Time.parse(value) when :Date Date.parse(value) when :String value.to_s when :Integer value.to_i when :Float value.to_f when :Boolean if value.to_s =~ /\A(true|t|yes|y|1)\z/i true else false end when :Object # generic object (usually a Hash), return directly value when /\AArray<(?.+)>\z/ inner_type = Regexp.last_match[:inner_type] value.map { |v| _deserialize(inner_type, v) } when /\AHash<(?.+?), (?.+)>\z/ k_type = Regexp.last_match[:k_type] v_type = Regexp.last_match[:v_type] {}.tap do |hash| value.each do |k, v| hash[_deserialize(k_type, k)] = _deserialize(v_type, v) end end else # model # models (e.g. Pet) or oneOf klass = Svix.const_get(type) klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value) end end # Returns the string representation of the object # @return [String] String presentation of the object def to_s to_hash.to_s end # to_body is an alias to to_hash (backward compatibility) # @return [Hash] Returns the object in the form of hash def to_body to_hash end # Returns the object in the form of hash # @return [Hash] Returns the object in the form of hash def to_hash hash = {} self.class.attribute_map.each_pair do |attr, param| value = self.send(attr) if value.nil? is_nullable = self.class.openapi_nullable.include?(attr) next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}")) end hash[param] = _to_hash(value) end hash end # Outputs non-array value in the form of hash # For object, use to_hash. Otherwise, just return the value # @param [Object] value Any valid value # @return [Hash] Returns the value in the form of hash def _to_hash(value) if value.is_a?(Array) value.compact.map { |v| _to_hash(v) } elsif value.is_a?(Hash) {}.tap do |hash| value.each { |k, v| hash[k] = _to_hash(v) } end elsif value.respond_to? :to_hash value.to_hash else value end end end end