bemyguest_sdk 1.0

data/LICENSE

@@ -0,0 +1,28 @@
+License: 
+========
+The MIT License (MIT)
+http://opensource.org/licenses/MIT
+
+Copyright (c) 2014 - 2016 APIMATIC Limited
+
+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.
+
+Trade Mark:
+==========
+APIMATIC is a trade mark for APIMATIC Limited

data/README.md

@@ -0,0 +1,43 @@
+BeMyGuestApiv1
+=================
+This API SDK was automatically generated by APIMATIC v2.0
+
+How To Configure:
+=================
+The generated code might need to be configured with your API credentials. To do that,
+provide the credentials and configuration values as a constructor parameters for the controllers
+
+How To Build: 
+=============
+The generated code uses a Ruby gem namely 'unirest'. The reference to this gem is
+already added in the gemspec. Therefore, you will need internet access to resolve
+this dependency.
+
+How To Use:
+===========
+The generated code can be used to build gem, which can then be distributed online.
+Otherwise, you can include the generated code in your project to use directly.
+
+Use the following steps to build a gem and use locally
+
+    1. Run the build command
+        ```
+        gem build be_my_guest_apiv_1.gemspec
+        ```
+
+    2. Run the install command  
+        ```
+        gem install ./be_my_guest_apiv_1-1.0.gem
+        ```
+
+    3. In your Gemfile add this line
+        ```
+        gem 'be_my_guest_apiv_1', '~> 1.0'
+        ```
+
+    4. Now create an instance and use the instance methods, like following.
+
+        ```
+        ctl = BeMyGuestApiv1::ConfigController.new params
+        ctl.get_retrieve_config params
+        ```

data/lib/be_my_guest_apiv_1.rb

@@ -0,0 +1,23 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+require 'openssl'
+require 'json'
+require 'unirest'
+
+# APIMATIC Helper Files
+require 'be_my_guest_apiv_1/api_helper.rb'
+require 'be_my_guest_apiv_1/api_exception.rb'
+require 'be_my_guest_apiv_1/configuration.rb'
+require 'be_my_guest_apiv_1/be_my_guest_apiv_1_client.rb'
+
+# Controllers
+require 'be_my_guest_apiv_1/controllers/config_controller.rb'
+require 'be_my_guest_apiv_1/controllers/bookings_controller.rb'
+require 'be_my_guest_apiv_1/controllers/products_controller.rb'
+
+# Models
+require 'be_my_guest_apiv_1/models/update_booking_request.rb'
+require 'be_my_guest_apiv_1/models/check_a_booking_request.rb'
+require 'be_my_guest_apiv_1/models/booking_statuses_enum.rb'
+require 'be_my_guest_apiv_1/models/create_a_booking_request.rb'
+require 'be_my_guest_apiv_1/models/booking_status_enum.rb'
+require 'be_my_guest_apiv_1/models/base_string_enum.rb'

data/lib/be_my_guest_apiv_1/api_exception.rb

@@ -0,0 +1,21 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class APIException < StandardError
+    # value store
+    attr_reader :response_code
+
+    # value store
+    attr_reader :response_body
+
+    # The HTTP response code from the API request
+    # @param [String] the reason for raising an exception
+    # @param [Numeric] the HTTP response code from the API request
+    # @param [Object] the HTTP unprased response from the API request
+    def initialize(reason, response_code, response_body)
+      super(reason)
+      @response_code = response_code
+      @response_body = response_body
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/api_helper.rb

@@ -0,0 +1,76 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class APIHelper
+    # Replaces template parameters in the given url
+    # @param [String] The query string builder to replace the template parameters
+    # @param [Array] The parameters to replace in the url
+    def self.append_url_with_template_parameters(query_builder, parameters)
+      # perform parameter validation
+      raise ArgumentError, 'Given value for parameter \"query_builder\" is invalid.' unless query_builder.is_a? String
+
+      # return if there are no parameters to replace
+      abort('no parameters to append') if parameters.nil?
+
+      # iterate and append parameters
+      parameters.map do |key, value|
+        replace_value = ''
+
+        if value.nil?
+          replace_value = ''
+        elsif value.is_a? Enumerable
+          replace_value = value.join('/')
+        else
+          replace_value = value.to_s
+        end
+
+        # find the template parameter and replace it with its value
+        query_builder = query_builder.gsub('{' + key.to_s + '}', replace_value)
+      end
+
+      query_builder
+    end
+
+    # Appends the given set of parameters to the given query string
+    # @param [String] The query string builder to replace the template parameters
+    # @param [Array] The parameters to append
+    def self.append_url_with_query_parameters(query_builder, parameters)
+      # perform parameter validation
+      raise ArgumentError, 'Given value for parameter \"query_builder\" is invalid.' unless query_builder.is_a? String
+
+      # return if there are no parameters to replace
+      abort('no parameters to append') if parameters.nil?
+
+      # remove any nil values
+      parameters = parameters.reject { |_key, value| value.nil? }
+
+      # does the query string already has parameters
+      has_params = query_builder.include? '?'
+      separator = has_params ? '&' : '?'
+
+      # append query with separator and parameters
+      query_builder << separator << URI.unescape(URI.encode_www_form(parameters))
+    end
+
+    # Validates and processes the given Url
+    # @param [String] The given Url to process
+    # @return [String] Pre-processed Url as string
+    def self.clean_url(url)
+      # perform parameter validation
+      raise ArgumentError, 'Invalid Url.' unless url.is_a? String
+
+      # ensure that the urls are absolute
+      matches = url.match(%r{^(https?:\/\/[^\/]+)})
+      raise ArgumentError, 'Invalid Url format.' if matches.nil?
+
+      # get the http protocol match
+      protocol = matches[1]
+
+      # remove redundant forward slashes
+      query = url[protocol.length..-1].gsub(%r{\/\/+}, '/')
+
+      # return process url
+      protocol + query
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/be_my_guest_apiv_1_client.rb

@@ -0,0 +1,33 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+# Require controllers
+require 'controllers/config_controller.rb'
+require 'controllers/bookings_controller.rb'
+require 'controllers/products_controller.rb'
+
+module BeMyGuestApiv1
+  class BeMyGuestAPIV1Client
+    # Singleton access to config controller
+    # @return [ConfigController] Returns the controller instance
+    def config
+      ConfigController.instance
+    end
+
+    # Singleton access to bookings controller
+    # @return [BookingsController] Returns the controller instance
+    def bookings
+      BookingsController.instance
+    end
+
+    # Singleton access to products controller
+    # @return [ProductsController] Returns the controller instance
+    def products
+      ProductsController.instance
+    end
+
+    # Initializer with authentication and configuration parameters
+    def initialize(x_authorization: nil)
+      Configuration.x_authorization = x_authorization
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/configuration.rb

@@ -0,0 +1,17 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class Configuration
+    # The base Uri for API calls
+    @base_uri = 'https://api.bemyguest.com.sg'
+
+    # X-Authorization API KEY Value
+    @x_authorization = 'TODO: Replace'
+
+    # create the getters and setters
+    class << self
+      attr_accessor :BASE_URI
+
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/controllers/bookings_controller.rb

@@ -0,0 +1,378 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class BookingsController
+    @@instance = BookingsController.new
+    # Singleton instance of the controller class
+    def self.instance
+      @@instance
+    end
+
+    # Updates Booking status information.Newly created booking has status `reserved`. In this status BeMyGuest inventory is not yet deducted.Inventory is locked after changing status of the booking from `reserved` to `waiting` (`confirm` action).When the booking is first created, it is marked as `reserved`. Inventories aren't touched yet. Once the partner decides to confirm the said booking, this is the only time the inventory will be impacted. The booking status will be updated from `reserved` to `waiting`.5 days after the booking date all booking with status `waiting` will be marked `expired`.There's 3rd extra action you may invoke in this method : `resend`. If `confirmationEmailSentAt` value is not null then the confirmation email copy sent o partner will be sent again and the timestamp value of this field will be updated.In response Booking object is returned, for example        {          "data": {              "uuid": "c53cbc74-1efa-58bb-afef-750afc52cd75",              "totalAmount": "123.98",              "currencyCode": "SGD",              "currencyUuid": "cd15153e-dfd1-5039-8aa3-115bec58e86e",              "totalAmountRequestCurrency": "369.46",              "requestCurrencyCode": "MYR",              "requestCurrencyUuid": "e98aaf89-ae5a-5c11-859a-b36f2c8e13c7",              "createdAt": "2015-12-21 19:53:23",              "updatedAt": "2015-12-21 19:53:23",              "arrivalDate": "2016-02-21",              "salutation": "Mr.",              "firstName": "test",              "lastName": "test",              "email": "test@126.com",              "phone": "123456789",              "guests": 2,              "children": 0,              "partnerReference": "test93828",              "confirmationEmailSentAt": null,              "confirmationEmailFiles": [],              "status": "reserved",              "productTypeTitle": "14% OFF for Family: E-Ticket to Universal Studios Singapore",              "productTypeTitleTranslated": "14% OFF for Family: E-Ticket to Universal Studios Singapore",              "productTypeUuid": "9b967f1a-89c2-5083-a758-e359deb2af9b"            }        }### Parameters+ uuid (required,string) - UUID of booking+ status (string) - Status "confirm" or "cancel"
+    # @param [String] status Required parameter: New status of the booking, one of [confirm, cancel, resend]
+    # @param [String] uuid Required parameter: UUID of booking
+    # @param [UpdateBookingRequest] data Optional parameter: TODO: type description here
+    # @return UpdateBookingStatusResponse response from the API call
+    def update_booking_status(status, uuid, data = nil)
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/bookings/{uuid}/{status}'
+
+      # process optional query parameters
+      query_builder = APIHelper.append_url_with_template_parameters query_builder, {
+        'status' => status,
+        'uuid' => uuid
+      }
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.put query_url, headers: headers, parameters: data.to_json
+
+      # Error handling using HTTP status codes
+      if response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+
+    # Creates a new booking.
+    # Newly created booking has always `reserved` status. It means it's not payed yet, not confirmed by partner but it's created and reserved in BeMyGuest database. 
+    # After creating a booking partner can do perform two scenarios:
+    # - either confirm booking - it means it's been paid by client to partner
+    # - ..or cancel
+    # After succesfull request - new booking object will be returned with status `waiting`.
+    # If you try to create new booking with the same `partnerReference` value as before you will get `GEN-FORBIDDEN` / `403` / `Booking with this partnerReference already exists` error in response.
+    # If you try to create a new booking with the total amount (in SGD) higher than the current available credit `walletAvailableBalance` value as before you will get `GEN-FORBIDDEN` / `403` / `Wallet balance too low to create a booking. Current balance: -90.98` error in response.
+    # If the product has timeslots, the `timeslotUUID` of the product is REQUIRED in `Check a Booking` and `Create a new booking` methods. Otherwise, it can be excluded.
+    # Please remember that with all Booking requests you need to providea proper Content-Type header.
+    # `Content-Type: application/json`
+    # Example JSON request:
+    #         {
+    #             "salutation": "Mr.",
+    #             "firstName": "Daryle",
+    #             "lastName": "De Silva",
+    #             "email": "daryle@bemyguest.com.sg",
+    #             "phone": "+6591591923",
+    #             "message": "Hello",
+    #             "productTypeUuid": "9d4b4d76-5b54-5407-b2d9-e6c021cc472e",
+    #             "pax": 2,
+    #             "children": 3,
+    #             "timeSlotUuid": "b02ae425-421f-5edf-a880-4104c0245dac",
+    #             "addons": [
+    #                 {
+    #                     "uuid": "37e0f490-d31d-521b-b1f0-95c6e4e38d4c",
+    #                     "quantity": "1"
+    #                 },
+    #                 {
+    #                     "uuid": "a50090e3-567d-5743-9d87-e9d261aad0a9",
+    #                     "quantity": "2"
+    #                 }
+    #                 ],
+    #             "arrivalDate": "2015-06-07",
+    #             "partnerReference" : "REF-001",
+    #             "usePromotion": false
+    #         }
+    # Example JSON response:
+    #     {
+    #         "data": {
+    #               "uuid": "c53cbc74-1efa-58bb-afef-750afc52cd75",
+    #               "totalAmount": "123.98",
+    #               "currencyCode": "SGD",
+    #               "currencyUuid": "cd15153e-dfd1-5039-8aa3-115bec58e86e",
+    #               "totalAmountRequestCurrency": "369.46",
+    #               "requestCurrencyCode": "MYR",
+    #               "requestCurrencyUuid": "e98aaf89-ae5a-5c11-859a-b36f2c8e13c7",
+    #               "createdAt": "2015-12-21 19:53:23",
+    #               "updatedAt": "2015-12-21 19:53:23",
+    #               "arrivalDate": "2016-02-21",
+    #               "salutation": "Mr.",
+    #               "firstName": "test",
+    #               "lastName": "test",
+    #               "email": "test@126.com",
+    #               "phone": "123456789",
+    #               "guests": 2,
+    #               "children": 0,
+    #               "partnerReference": "test93828",
+    #               "confirmationEmailSentAt": null,
+    #               "confirmationEmailFiles": [],
+    #               "status": "reserved",
+    #               "productTypeTitle": "14% OFF for Family: E-Ticket to Universal Studios Singapore",
+    #               "productTypeTitleTranslated": "14% OFF for Family: E-Ticket to Universal Studios Singapore",
+    #               "productTypeUuid": "9b967f1a-89c2-5083-a758-e359deb2af9b"
+    #         }
+    #     }
+    # Example JSON error message when Wallet balance is lower than the new booking :
+    #     {
+    #         "error": {
+    #             "code": "GEN-FORBIDDEN",
+    #             "http_code": 403,
+    #             "message": "Wallet balance too low to create a booking. Current balance: -90.98"
+    #         }
+    #     }
+    # @param [CreateABookingRequest] body Required parameter: TODO: type description here
+    # @return CreateABookingResponse response from the API call
+    def create_a_booking(body)
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/bookings'
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.post query_url, headers: headers, parameters: body.to_json
+
+      # Error handling using HTTP status codes
+      if response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+
+    # Get a list of bookings.A request can take these parameters:+ `date_start`: As compared with arrivalDate, format YYYY-MM-DD+ `date_end`: As compared with arrivalDate, format YYYY-MM-DD+ `first_name`: Guest's first name+ `last_name`: Guest's last name+ `email`: Guest's email address+ `phone`: Guest's contact number+ `partner_reference`: The given unique partnerReference ID of this booking.+ `page`: Page number for results+ `per_page`: How many results per page - if not provided default value from user account will be used+ `query`: Free phrase for text search for example &query=John###ResponseA response object has the following attributes:  + `uuid` - UUID of the booking+ `totalAmount` - Total amount of the booking+ `currencyCode` - Currency code used in this booking+ `currencyUuid` - UUID of the `currencyCode`+ `totalAmountRequestCurrency` - Total amount of the booking in the requested currency. (The requested currency is set in user's profile).+ `requestCurrencyCode` - Currency used by `totalAmountRequestCurrency`+ `requestCurrencyUuid` - UUID of the requested currency+ `createdAt` - The booking's created date+ `updatedAt` - The last updated date+ `arrivalDate` - The arrival date+ `salutation` - Available salutation title: "Mr.", "Ms.", "Mrs."+ `firstName` - Guest's first name+ `lastName` - Guest's last name+ `email` - Guest's email address+ `phone` - Guest's contact number+ `guests` - Number of guests(adults) in this booking+ `children` - Number of children in this booking+ `partnerReference` - The given unique partnerReference ID of this booking.+ `confirmationEmailSentAt` - The sent out time of theconfirmation email + `confirmationEmailFiles` - The confirmation email files of this booking+ `status` - The booking status+ `productTypeTitle` - The productType's title of this booking+ `productTypeTitleTranslated` - The translated productType's title of this booking+ `productTypeUuid` - The productType UUID of this booking.
+    # @param [String] date_end Optional parameter: As compared with arrivalDate, format YYYY-MM-DD
+    # @param [String] date_start Optional parameter: As compared with arrivalDate, format YYYY-MM-DD
+    # @param [String] email Optional parameter: Guest's email address
+    # @param [String] first_name Optional parameter: Guest's first name
+    # @param [String] last_name Optional parameter: Guest's last name
+    # @param [String] page Optional parameter: Page number for results
+    # @param [String] partner_reference Optional parameter: The given unique partnerReference ID of this booking
+    # @param [String] per_page Optional parameter: How many results per page - if not provided default value from user account will be used
+    # @param [String] phone Optional parameter: Guest's contact number
+    # @param [String] query Optional parameter: Free phrase for text search for example &query=John
+    # @param [BookingStatusesEnum] status Optional parameter: Filter bookings by status reserved|waiting|cancelled|approved|expired|rejected|released|refunded
+    # @return GetBookingsResponse response from the API call
+    def get_bookings(date_end = nil, date_start = nil, email = nil, first_name = nil, last_name = nil, page = nil, partner_reference = nil, per_page = nil, phone = nil, query = nil, status = nil)
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/bookings/'
+
+      # process optional query parameters
+      query_builder = APIHelper.append_url_with_query_parameters query_builder, {
+        'date_end' => date_end,
+        'date_start' => date_start,
+        'email' => email,
+        'first_name' => first_name,
+        'last_name' => last_name,
+        'page' => page,
+        'partner_reference' => partner_reference,
+        'per_page' => per_page,
+        'phone' => phone,
+        'query' => query,
+        'status' => status
+      }
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.get query_url, headers: headers
+
+      # Error handling using HTTP status codes
+      if response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+
+    # `Check if booking is possible` method request requires lesser parameters as compared to `Create a booking`.In fact before creating a booking we advise to run this request first:- it will check if booking can be made without writing any data in BMG database- it will provide a correct total amount for selected services- if partner is caching products this should be used just before creating a booking - so any differences in cached prices (on partner side) and current price for total amount can be discovered- if partner discover difference in provided total amount then he can act accordingly in his user/client interface (for example - ask customer to accept final changed price)The main difference is that no booking is created in the system and some fields in response JSON object have NULL values. If the product has timeslots, the `timeslotUUID` of the product is REQUIRED in `Check a Booking` and `Create a new booking` methods. Otherwise, it can be excluded.For `booking check` request you don't have to pass customer's data or `partnerReference`.Example JSON request:        {            "productTypeUuid": "9d4b4d76-5b54-5407-b2d9-e6c021cc472e",            "pax": 2,            "children": 3,            "timeSlotUuid": "b02ae425-421f-5edf-a880-4104c0245dac",            "addons": [                {                    "uuid": "37e0f490-d31d-521b-b1f0-95c6e4e38d4c",                    "quantity": "1"                },                {                    "uuid": "a50090e3-567d-5743-9d87-e9d261aad0a9",                    "quantity": "2"                }                ],            "arrivalDate": "2015-06-07",            "usePromotion": false        }Response example:        {          "data": {              "uuid": null,              "totalAmount": "123.98",              "currencyCode": "SGD",              "currencyUuid": "cd15153e-dfd1-5039-8aa3-115bec58e86e",              "totalAmountRequestCurrency": "369.46",              "requestCurrencyCode": "MYR",              "requestCurrencyUuid": "e98aaf89-ae5a-5c11-859a-b36f2c8e13c7",              "createdAt": null,              "updatedAt": null,              "arrivalDate": "2015-06-07",              "salutation": null,              "firstName": null,              "lastName": null,              "email": null,              "phone": null,              "guests": 2,              "children": 3,              "partnerReference": null,              "confirmationEmailSentAt": null,              "confirmationEmailFiles": [],              "status": null,              "productTypeTitle": null,              "productTypeTitleTranslated": null,              "productTypeUuid": "9d4b4d76-5b54-5407-b2d9-e6c021cc472e"          }        }
+    # @param [CheckABookingRequest] body Required parameter: TODO: type description here
+    # @return CheckABookingResponse response from the API call
+    def create_check_a_booking(body)
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/bookings/check'
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.post query_url, headers: headers, parameters: body.to_json
+
+      # Error handling using HTTP status codes
+      if response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+
+    # Get Booking status information.
+    # Possible status return values:
+    # - `reserved` - booking created but not confirmed by partner
+    # - `waiting` - booking confirmed by partner (for example payed on partned side)
+    # - `approved` - booking confirmed by supplier
+    # - `cancelled` - cancelled by partner or BeMyGuest
+    # - `expired` - no action has been done by supplier or BeMyGuest and booking has expired
+    # - `rejected` - supplier rejected booking
+    # In response Booking object is returned, for example
+    #         {
+    #           "data": {
+    #               "uuid": "c53cbc74-1efa-58bb-afef-750afc52cd75",
+    #               "totalAmount": "123.98",
+    #               "currencyCode": "SGD",
+    #               "currencyUuid": "cd15153e-dfd1-5039-8aa3-115bec58e86e",
+    #               "totalAmountRequestCurrency": "369.46",
+    #               "requestCurrencyCode": "MYR",
+    #               "requestCurrencyUuid": "e98aaf89-ae5a-5c11-859a-b36f2c8e13c7",
+    #               "createdAt": "2015-12-21 19:53:23",
+    #               "updatedAt": "2015-12-21 19:53:23",
+    #               "arrivalDate": "2016-02-21",
+    #               "salutation": "Mr.",
+    #               "firstName": "test",
+    #               "lastName": "test",
+    #               "email": "test@126.com",
+    #               "phone": "123456789",
+    #               "guests": 2,
+    #               "children": 0,
+    #               "partnerReference": "test93828",
+    #               "confirmationEmailSentAt": null,
+    #               "confirmationEmailFiles": [],
+    #               "status": "reserved",
+    #               "productTypeTitle": "14% OFF for Family: E-Ticket to Universal Studios Singapore",
+    #               "productTypeTitleTranslated": "14% OFF for Family: E-Ticket to Universal Studios Singapore",
+    #               "productTypeUuid": "9b967f1a-89c2-5083-a758-e359deb2af9b"
+    #             }
+    #         }
+    # ###Parameters
+    # + uuid (required,string) - UUID of booking
+    # @param [String] uuid Required parameter: UUID of booking
+    # @return GetBookingStatusResponse response from the API call
+    def get_booking_status(uuid)
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/bookings/{uuid}'
+
+      # process optional query parameters
+      query_builder = APIHelper.append_url_with_template_parameters query_builder, {
+        'uuid' => uuid
+      }
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.get query_url, headers: headers
+
+      # Error handling using HTTP status codes
+      if response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/controllers/config_controller.rb

@@ -0,0 +1,53 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class ConfigController
+    @@instance = ConfigController.new
+    # Singleton instance of the controller class
+    def self.instance
+      @@instance
+    end
+
+    # A Config object has the following attributes:+ `timezone` - Our sever timezone+ `now` - Our server timestamp+ `version` - Current version is "1.0"+ `serverUrl` - Main API URL+ `photosUrl` - Base Path to server where we store our images+ `productsSorting` - Available Products lists sorting options (can be combined with commas, for example &sort=date,-price )    + `date` - Date ascending    + `-date` - Date descending    + `price` - Price ascending    + `-price` - Price descending    + `distance` - Distance ascending (works only if `latitude`,`longitude` & `distance` parameters are provided, ignored otherwise)     + `-distance` - Distance descending (works only if `latitude`,`longitude` & `distance` parameters are provided, ignored otherwise)+ user - All important userdata for provided API key    + `name` - Name / Company / Organization    + `email` - E-Mail Address    + `uuid` - Unique ID    + `continueUrl` - Continue URL (not in use now)    + `notifyUrl` - Notify URL (not in use now)    + `suggestedMarkup` - Suggested markup, % decimal value, for example 7.5    + `defaultPagination` - Default Pagination value (per page), between 1-100    + `defaultSortBy` - Default sort by for /products (if not specified)    + `defaultCurrencyUuid` - Default currency UUID for /products (if not specified)    + `defaultCurrencyCode` - Default currency code for /products (if not specified)    + `defaultLanguageUuid` - Default language UUID  /products (if not specified)    + `defaultLanguageCode` - Default language code  /products (if not specified)    + `walletBalance` - Partner's available wallet balance, based on his deposits    + `walletAvailableBalance` - Wallet balance which is a combination of partner's deposit and assigned credit amount    + `wallet_alert_value` - Threshold value in SGD, when `walletBallance` reach this value then BMG and partner will be notified on this event+ `languages` - A list of supported languages.+ `currencies` - An array of supported currencies.+ `types` - An array of supported products types.+ `categories` - A tree of supported product categories.+ `locations` - A tree of supported locations. (Continent -> Country -> State -> City)
+    # @return RetrieveConfigResponse response from the API call
+    def retrieve_config
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/config'
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.get query_url, headers: headers
+
+      # Error handling using HTTP status codes
+      if response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/controllers/products_controller.rb

@@ -0,0 +1,161 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class ProductsController
+    @@instance = ProductsController.new
+    # Singleton instance of the controller class
+    def self.instance
+      @@instance
+    end
+
+    # Get information about product using its UUID as parameter.###Response+ `uuid` - UUID of product+ `published` - true / false+ `title` - Title of product. Everytime on English+ `titleTranslated` - Title of product on requested language+ `description` - Description of product. Everytime on English+ `descriptionTranslated` - Description of product on requested language+ `highlights` - Highlights of product. Everytime on English+ `highlightsTranslated` - Highlights of product on requested language+ `additionalInfo` - Additional information of product. Everytime on English+ `additionalInfoTranslated` - Additional information of product on requested language+ `priceIncludes` - What's included in product price+ `priceIncludesTranslated` - Translated version of `priceIncludes`+ `itinerary` - Activity itinerary - only applicable for Package type, will be `NULL` for others+ `itineraryTranslated` - translated version of itinerary+ `warnings` - Warnings of the activity (related to safety and insurance)+ `warningsTranslated` - translated version of warnings+ `safety` - activity safety information+ `safetyTranslated` - translated version of safety information+ `latitude` - Latitude+ `longitude` - Longitude+ `minPax` - Minimum number of pax+ `maxPax` - Maximum number of pax+ `basePrice` - Base price of product (for list only)+ `currency` - Currency+ `isFlatPaxPrice` - `true/false` (An indication to tell if the `Product` has the same price for each pax in all of its `productTypes`)+ `reviewCount` - Number of reviews+ `reviewAverageScore` - Average score+ `typeName` - Type of product+ `typeUuid` - Type UUID+ `businessHoursFrom` - supplier business hours `from`+ `businessHoursTo` - supplier business hours `to`+ `meetingTime` - meeting time+ `hotelPickup` - false+ `meetingLocation` - instructions about meeting location with supplier+ `meetingLocationTranslated` - translated version of meeting location+ `photosUrl` - Base URL for images+ `photos` - Array of photos in different dimensions (Sizes: original, 75x50, 175x112, 680x325)+ `categories` - Array of categories+ `productTypes`    + `uuid` - UUID of Product Type    + `title` - Title of Product Type    + `titleTranslated` - Translated version of title    + `description` - Description of Product Type    + `descriptionTranslated` - translated version of description    + `durationDays` - duration in days    + `durationHours` - duration in hours    + `durationMinutes` - duration in  minutes    + `paxMin` - Minimum number of people    + `paxMax` - Maximum number of people    + `daysInAdvance` - how many days in advance booking can be made    + `isNonRefundable` - True if product not refundable    + `hasChildPrice` - Does product has child price    + `minAdultAge` - The minimum age allowed for an adult    + `maxAdultAge` - The maximum age allowed for an adult    + `allowChildren` - Is a child allowed for this product    + `minChildAge` - The minimum age allowed for a child    + `maxChildAge` - The maximum age allowed for a child    + `instantConfirmation` - if it's TRUE then booking this product should return new Booking status = `approved`, but if we're out of stock of e-tickets it can still return `waiting`     + `voucherUse` - instruction on how to use the voucher (Using what? Go to what palce? To redeem with who?)    + `voucherUseTranslated` - translated version of how to use voucher    + `voucherRedemptionAddress` - Voucher redemption address IF client needs to redeem a voucher.     + `voucherRedemptionAddressTranslated` - translated version of `voucherRedemptionAddress`    + `recommendedMarkup` - Apply this markup if you want to match with BMG's website prices    + `prices` - List of prices for Product Type for one month. The prices array consist of price for adults depending of number of adults and price for child.    + `timeSlots` - Available timeslots for product, might be `null`. If the `ProductType` has timeslots, the `timeslotUUID` of the product is REQUIRED in `Check a Booking` and `Create a new booking` methods.+ `addons` - Add-ons for product+ `locations` - Information about product location+ `url` - URL of product + `staticUrl` - Static URL of product+ `guideLanguages` - Available languages speak by tour guide.+ `audioHeadsetLanguages` - Available languages for Audio Headset material.+ `writtenLanguages` - Available written languages for reading material.If product has been deleted from BeMyGuest database response will be:        {          "error": {            "code": "GEN-GONE",            "http_code": 410,            "message": "Resource No Longer Available"          }        }### Promotional pricesExample of promotion data block:        "promotion": {              "type": "early_booking",              "daysInAdvance": 30,              "hoursInAdvance": null,              "name": "Early Bird",              "adult": {                "2": 93.45              },              "child": 0,              "discountPercent": 30,              "cancellationPolicy": []        }- If product type has promotional prices for selected date only one promotion (with best price) will be visible in API.- there are 3 types of promotions (`type` parameter) : `early_booking`, `last_minute` and `discount`- `early_booking` will have value for `daysInAdvance` parameter provided (`hoursInAdvance` will be `NULL`)- `last_minute` will have value for `hoursInAdvance` provided (`daysInAdvance` will be `NULL`)- `discount` type will have both `daysInAdvance` and `hoursInAdvance` set to `NULL`
+    # @param [String] uuid Required parameter: UUID of product
+    # @param [String] currency Optional parameter: currency UUID, also currency code may be provided in exchange
+    # @param [String] date_end Optional parameter: product's prices end date, format YYYY-MM-DD
+    # @param [String] date_start Optional parameter: product's prices start date, format YYYY-MM-DD
+    # @param [String] language Optional parameter: language UUID, also language code may be provided
+    # @return GETProductResponse response from the API call
+    def get_product(uuid, currency = nil, date_end = nil, date_start = nil, language = nil)
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/products/{uuid}/'
+
+      # process optional query parameters
+      query_builder = APIHelper.append_url_with_template_parameters query_builder, {
+        'uuid' => uuid
+      }
+
+      # process optional query parameters
+      query_builder = APIHelper.append_url_with_query_parameters query_builder, {
+        'currency' => currency,
+        'date_end' => date_end,
+        'date_start' => date_start,
+        'language' => language
+      }
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.get query_url, headers: headers
+
+      # Error handling using HTTP status codes
+      if response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+
+    # ###ResponseA response object has the following attributes:  + `uuid` - UUID of product+ `published` - true / false,+ `title` - Title of product. Always on English+ `titleTranslated` - Title of product on requested language+ `description` - Description of product. Always on English+ `descriptionTranslated` - Description of product on requested language+ `highlights` - Highlights of product. Always on English+ `highlightsTranslated` - Highlights of product on requested language+ `additionalInfo` - Additional information of product. Always on English+ `additionalInfoTranslated` - Additional information of product on requested language+ `priceIncludes` - What's included in product price+ `priceIncludesTranslated` - Translated version of `priceIncludes`+ `itinerary` - Activity itinerary - only applicable for Package type, will be `NULL` for others+ `itineraryTranslated` - translated version of itinerary+ `warnings` - Warnings of the activity (related to safety and insurance)+ `warningsTranslated` - translated version of warnings+ `safety` - activity safety information+ `safetyTranslated` - translated version of safety information+ `latitude` - Latitude+ `longitude` - Longitude+ `minPax` - Minimum number of pax+ `maxPax` - Maximum number of pax+ `basePrice` - Base price of product (for list only)+ `currency` - Currency+ `isFlatPaxPrice` - `true/false` (An indication to tell if the `Product` has the same price for each pax in all of its `productTypes` for the selected date. )+ `reviewCount` - Number of reviews+ `reviewAverageScore` - Average score+ `typeName` - Type of product+ `typeUuid` - Type UUID+ `businessHoursFrom` - supplier business hours `from`+ `businessHoursTo` - supplier business hours `to`+ `meetingTime` - meeting time+ `hotelPickup` - `true/false` + `meetingLocation` - instructions about meeting location with supplier+ `meetingLocationTranslated` - translated version of meeting location+ `photosUrl` - Base URL for images+ `photos` - Array of photos in different dimensions (Sizes: original, 75x50, 175x112, 680x325)+ `categories` - Array of categories+ `locations` - Information about product location+ `url` - URL of product If you requested only unpublished (`published` = `false`) products then the list will be simplified.Each element will consist only of these attributes:        {          "data": [            {                "uuid":"b03ce312-742f-5256-bfe2-014daf1c8d01",                "published":false,                "title":"Everest BaseCamp Trek - 16 Days",                "titleTranslated":null            },            {                "uuid":"d70fb77c-3e97-591e-b876-d638a643c41b",                "published":false,                "title":"Half day rock climbing, Ha Long Bay, Vietnam",                "titleTranslated":null            }            [...]        }If you requested only deleted (`deleted` = `false`) products then the list will be simplified.In this case `published` parameter will be ignored.This parameter exists to help partners to synchronize its cached products database.Each element will consist only of these attributes:        {          "data": [            {                "uuid":"b03ce312-742f-5256-bfe2-014daf1c8d01",                "deletedAt":"2015-06-01 14:28:37",                "title":"Everest BaseCamp Trek - 16 Days",                "titleTranslated":null            },            {                "uuid":"d70fb77c-3e97-591e-b876-d638a643c41b",                "published":"deletedAt":"2015-06-01 14:28:37",                "title":"Half day rock climbing, Ha Long Bay, Vietnam",                "titleTranslated":null            }            [...]        }###RequestA request can take these parameters:+ `type`: `b90bd912-3e92-52e6-8abb-c2722cf947db` (optional, string) - UUID of type of product+ `country`: `ebbfac98-5f89-5106-9c4e-9e5dfd485231` (optional, string) - UUID of country+ `city`: `f67e3919-036d-11e5-a2a9-d07e352b4840` (optional, string) - UUID of city - it will always overwrite (nullify) country parameter if provided+ `price_min`: 25.00 (optional, decimal) - minimal price in decimal format 000.00 - it's compared to base price+ `price_max`: 100.00 (optional, decimal) - max price in decimal format 000.00+ `category`: `5a6495b5-9a58-5257-93db-902ca3cf8b40` (optional, string) - UUID of litsing category+ `pax`: `2` (optional, integer) - number of guests+ `currency`: `79efbd4e-3648-5204-8f35-a0e51661a4c7` (optional, string) - currency UUID, also currency code may be provided in exchange+ `language`: `ZH-HANS` (optional, string) - language UUID, also language code may be provided+ `date_start`: `2015-06-25` (optional, string) - product start date, format YYYY-MM-DD+ `date_end`: `2015-06-30` (optional, string) - product end date, format YYYY-MM-DD+ `query`: `diving in Bali` (optional, string) - free phrase for text search for example &query=Bali+ `duration_days_min`: `0` (optional,integer) - product duration minimum days (default 0)+ `duration_days_max`: `0` (optional,integer) - product duration maximum days (default NULL)+ `latitude`: `1.313430` (optional, float) - search in distance radius: latitude value + `longitude`: `103.883768` (optional, float) - search in distance radius: longitude value+ `distance`: `10.5` (optional, float) - search in distance radius in km - to use this param you need to provide always 3 parameters: latitude, longitude and distance+ `sort`: `price` (optional, string) - sorting field, example: &sort=date,-price  or &sort=price+ `page`: `5` (optional, integer) - page number for results+ `per_page`: `25` (optional, integer) - how many results per page - if not provided default value from user account will be used+ `published`: `true` (optional, string) - default is set to true, if set to false then a list of shortened unpublished products will be returned+ `deleted`: `false` (optional, string) - default is set to false, if set to true then a list of shortened deleted products will be returned
+    # @param [String] category Optional parameter: UUID of litsing category
+    # @param [String] city Optional parameter: UUID of city, it will always overwrite country parameter if provided
+    # @param [String] country Optional parameter: UUID of country
+    # @param [String] currency Optional parameter: currency UUID, also currency code may be provided in exchange
+    # @param [String] date_end Optional parameter: product end date, format YYYY-MM-DD
+    # @param [String] date_start Optional parameter: product start date, format YYYY-MM-DD
+    # @param [String] deleted Optional parameter: default is set to `false`
+    # @param [String] distance Optional parameter: Distance in km
+    # @param [Numeric] duration_days_max Optional parameter: product duration maximum days (default NULL)
+    # @param [Numeric] duration_days_min Optional parameter: product duration minimum days (default 0)
+    # @param [String] language Optional parameter: language UUID, also language code may be provided. It will overwrite the default language from user account
+    # @param [String] latitude Optional parameter: Latitude value
+    # @param [String] longitude Optional parameter: Longitute value
+    # @param [Double] page Optional parameter: page number for results
+    # @param [Double] pax Optional parameter: number of people
+    # @param [Double] per_page Optional parameter: how many results per page - if not provided default value from user account will be used
+    # @param [Numeric] price_max Optional parameter: max price in decimal format 000.00
+    # @param [Numeric] price_min Optional parameter: minimal price in decimal format 000.00 - it's compared to base price
+    # @param [String] published Optional parameter: default is always set to `true`
+    # @param [String] query Optional parameter: free phrase for text search for example &query=Bali
+    # @param [String] sort Optional parameter: sorting field, example: &sort=date,-price  or &sort=price
+    # @param [String] type Optional parameter: UUID of type of product
+    # @return GETProductsResponse response from the API call
+    def get_products_list(category = nil, city = nil, country = nil, currency = nil, date_end = nil, date_start = nil, deleted = nil, distance = nil, duration_days_max = nil, duration_days_min = nil, language = nil, latitude = nil, longitude = nil, page = nil, pax = nil, per_page = nil, price_max = nil, price_min = nil, published = nil, query = nil, sort = nil, type = nil)
+      # the base uri for api requests
+      query_builder = Configuration.base_uri.dup
+
+      # prepare query string for API call
+      query_builder << '/v1/products'
+
+      # process optional query parameters
+      query_builder = APIHelper.append_url_with_query_parameters query_builder, {
+        'category' => category,
+        'city' => city,
+        'country' => country,
+        'currency' => currency,
+        'date_end' => date_end,
+        'date_start' => date_start,
+        'deleted' => deleted,
+        'distance' => distance,
+        'duration_days_max' => duration_days_max,
+        'duration_days_min' => duration_days_min,
+        'language' => language,
+        'latitude' => latitude,
+        'longitude' => longitude,
+        'page' => page,
+        'pax' => pax,
+        'per_page' => per_page,
+        'price_max' => price_max,
+        'price_min' => price_min,
+        'published' => published,
+        'query' => query,
+        'sort' => sort,
+        'type' => type
+      }
+
+      # validate and preprocess url
+      query_url = APIHelper.clean_url query_builder
+
+      # prepare headers
+      headers = {
+        'user-agent' => 'BeMyGuest.SDK.v1',
+        'accept' => 'application/json',
+        'X-Authorization' => Configuration.x_authorization
+      }
+
+      # invoke the API call request to fetch the response
+      response = Unirest.get query_url, headers: headers
+
+      # Error handling using HTTP status codes
+      if response.code == 400
+        raise APIException.new 'Wrong Arguments', 400, response.raw_body
+      elsif response.code == 401
+        raise APIException.new 'Unauthorized', 401, response.raw_body
+      elsif response.code == 403
+        raise APIException.new 'Forbidden', 403, response.raw_body
+      elsif response.code == 404
+        raise APIException.new 'Resource Not Found', 404, response.raw_body
+      elsif response.code == 405
+        raise APIException.new 'Method Not Allowed', 405, response.raw_body
+      elsif response.code == 410
+        raise APIException.new 'Resource No Longer Available', 410, response.raw_body
+      elsif !response.code.between?(200, 206) # [200,206] = HTTP OK
+        raise APIException.new 'HTTP Response Not OK', response.code, response.raw_body
+      end
+
+      response.body
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/models/base_string_enum.rb

@@ -0,0 +1,25 @@
+# Extracted from Remote API gem (https://github.com/cstrahan/rapi).
+
+module BeMyGuestApiv1
+  class BaseStringEnum
+
+    private
+    def self.enum_attr(name, val)
+      name = name.to_s
+
+      define_method(name + '?') do
+        @attrs == val
+      end
+    end
+
+    public
+    def initialize(attrs = '')
+      @attrs = attrs
+    end
+
+    def to_s
+      @attrs
+    end
+
+  end
+end

data/lib/be_my_guest_apiv_1/models/booking_status_enum.rb

@@ -0,0 +1,18 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+require 'be_my_guest_apiv_1/models/base_string_enum'
+
+module BeMyGuestApiv1
+  class BookingStatusEnum < BaseStringEnum
+
+    # Confirms given booking
+    enum_attr :CONFIRM, 'confirm'
+
+    # Cancels given booking
+    enum_attr :CANCEL, 'cancel'
+
+    # If confirmationEmailSentAt value is not null then copy of the confirmation email sent to partner will be sent again and the timestamp value of this field will be updated
+    enum_attr :RESEND, 'resend'
+
+  end
+end

data/lib/be_my_guest_apiv_1/models/booking_statuses_enum.rb

@@ -0,0 +1,33 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+require 'be_my_guest_apiv_1/models/base_string_enum'
+
+module BeMyGuestApiv1
+  class BookingStatusesEnum < BaseStringEnum
+
+    # TODO: Write general description for this element
+    enum_attr :RESERVED, 'reserved'
+
+    # TODO: Write general description for this element
+    enum_attr :WAITING, 'waiting'
+
+    # TODO: Write general description for this element
+    enum_attr :CANCELLED, 'cancelled'
+
+    # TODO: Write general description for this element
+    enum_attr :APPROVED, 'approved'
+
+    # TODO: Write general description for this element
+    enum_attr :EXPIRED, 'expired'
+
+    # TODO: Write general description for this element
+    enum_attr :REJECTED, 'rejected'
+
+    # TODO: Write general description for this element
+    enum_attr :RELEASED, 'released'
+
+    # TODO: Write general description for this element
+    enum_attr :REFUNDED, 'refunded'
+
+  end
+end

data/lib/be_my_guest_apiv_1/models/check_a_booking_request.rb

@@ -0,0 +1,56 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class CheckABookingRequest
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :product_type_uuid
+
+    # TODO: Write general description for this method
+    # @return [Numeric]
+    attr_accessor :pax
+
+    # TODO: Write general description for this method
+    # @return [Numeric]
+    attr_accessor :children
+
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :time_slot_uuid
+
+    # TODO: Write general description for this method
+    # @return [Array<mixed>]
+    attr_accessor :addons
+
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :arrival_date
+
+    # TODO: Write general description for this method
+    # @return [Boolean]
+    attr_accessor :use_promotion
+
+    def method_missing(method_name)
+      puts "there's no method called '#{method_name}'"
+    end
+
+    # Creates JSON of the curent object
+    def to_json
+      hash = key_map
+      hash.to_json
+    end
+
+    # Defines the key map for json serialization
+    def key_map
+      hash = {}
+      hash['productTypeUuid'] = product_type_uuid
+      hash['pax'] = pax
+      hash['children'] = children
+      hash['timeSlotUuid'] = time_slot_uuid
+      hash['addons'] = addons
+      hash['arrivalDate'] = arrival_date
+      hash['usePromotion'] = use_promotion
+      hash
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/models/create_a_booking_request.rb

@@ -0,0 +1,91 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class CreateABookingRequest
+    # One of Mr.|Ms.|Mrs.
+    # @return [String]
+    attr_accessor :salutation
+
+    # Guest's first name
+    # @return [String]
+    attr_accessor :first_name
+
+    # Guest's last name
+    # @return [String]
+    attr_accessor :last_name
+
+    # Guest's email address
+    # @return [String]
+    attr_accessor :email
+
+    # Guest's phone number
+    # @return [String]
+    attr_accessor :phone
+
+    # Message to the host
+    # @return [String]
+    attr_accessor :message
+
+    # UUID of the ProductType
+    # @return [String]
+    attr_accessor :product_type_uuid
+
+    # Number of adults
+    # @return [Numeric]
+    attr_accessor :pax
+
+    # Number of children
+    # @return [Numeric]
+    attr_accessor :children
+
+    # Selected timeslot. If the product has timeslots, the "timeslotUUID" of the product is REQUIRED in "Check a Booking" and "Create a new booking" methods. Otherwise, it can be excluded
+    # @return [String]
+    attr_accessor :time_slot_uuid
+
+    # Add-ons for product (array of uuid/quantity values)
+    # @return [Array<mixed>]
+    attr_accessor :addons
+
+    # Arrival date in YYYY-MM-DD format
+    # @return [String]
+    attr_accessor :arrival_date
+
+    # Maximum 36 characters partner reference code or number
+    # @return [String]
+    attr_accessor :partner_reference
+
+    # f API should check price against "promotion" and not "regular" , default is set to "false"
+    # @return [Boolean]
+    attr_accessor :use_promotion
+
+    def method_missing(method_name)
+      puts "there's no method called '#{method_name}'"
+    end
+
+    # Creates JSON of the curent object
+    def to_json
+      hash = key_map
+      hash.to_json
+    end
+
+    # Defines the key map for json serialization
+    def key_map
+      hash = {}
+      hash['salutation'] = salutation
+      hash['firstName'] = first_name
+      hash['lastName'] = last_name
+      hash['email'] = email
+      hash['phone'] = phone
+      hash['message'] = message
+      hash['productTypeUuid'] = product_type_uuid
+      hash['pax'] = pax
+      hash['children'] = children
+      hash['timeSlotUuid'] = time_slot_uuid
+      hash['addons'] = addons
+      hash['arrivalDate'] = arrival_date
+      hash['partnerReference'] = partner_reference
+      hash['usePromotion'] = use_promotion
+      hash
+    end
+  end
+end

data/lib/be_my_guest_apiv_1/models/update_booking_request.rb

@@ -0,0 +1,31 @@
+# This file was automatically generated for BeMyGuest by APIMATIC v2.0 on 05/03/2016
+
+module BeMyGuestApiv1
+  class UpdateBookingRequest
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :uuid
+
+    # TODO: Write general description for this method
+    # @return [BookingStatusEnum]
+    attr_accessor :status
+
+    def method_missing(method_name)
+      puts "there's no method called '#{method_name}'"
+    end
+
+    # Creates JSON of the curent object
+    def to_json
+      hash = key_map
+      hash.to_json
+    end
+
+    # Defines the key map for json serialization
+    def key_map
+      hash = {}
+      hash['uuid'] = uuid
+      hash['status'] = status
+      hash
+    end
+  end
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: bemyguest_sdk
+version: !ruby/object:Gem::Version
+  version: '1.0'
+  prerelease: 
+platform: ruby
+authors:
+- APIMATIC
+- Zeeshan Ejaz Bhatti
+- BeMyGuest
+- Jarek Tkaczyk @ BeMyGuest
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-05-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: unirest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.2
+description: SDK for the BeMyGuest REST API. This API SDK was automatically generated
+  by APIMATIC v2.0
+email: tech@bemyguest.com.sg
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/be_my_guest_apiv_1.rb
+- lib/be_my_guest_apiv_1/configuration.rb
+- lib/be_my_guest_apiv_1/api_exception.rb
+- lib/be_my_guest_apiv_1/models/create_a_booking_request.rb
+- lib/be_my_guest_apiv_1/models/booking_status_enum.rb
+- lib/be_my_guest_apiv_1/models/update_booking_request.rb
+- lib/be_my_guest_apiv_1/models/booking_statuses_enum.rb
+- lib/be_my_guest_apiv_1/models/base_string_enum.rb
+- lib/be_my_guest_apiv_1/models/check_a_booking_request.rb
+- lib/be_my_guest_apiv_1/controllers/bookings_controller.rb
+- lib/be_my_guest_apiv_1/controllers/products_controller.rb
+- lib/be_my_guest_apiv_1/controllers/config_controller.rb
+- lib/be_my_guest_apiv_1/api_helper.rb
+- lib/be_my_guest_apiv_1/be_my_guest_apiv_1_client.rb
+- README.md
+- LICENSE
+homepage: https://docs.bemyguest.apiary.io
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ~>
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: bemyguest_api_sdk
+test_files: []