quandoo 1.0.0

data/lib/quandoo/api/reviews_api.rb

@@ -0,0 +1,241 @@
+=begin
+#Quandoo API Documentation
+
+#No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.5
+
+=end
+
+require 'uri'
+
+module Quandoo
+  class ReviewsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Create a review for a reservation
+    # This resource manages the creation of reviews for a particular agent and a reservation. Reviews must have a description, rating and a reservation public identifier. The agent must be the one that created the reservation, otherwise it is forbidden.  ####Request: The request needs to have 3 parameters for review reviewId, description and rating.  * **reservationId**: Public ID of the reservation where to add a review. **Required**. * **description**: Text content of the review to be set. Optional. A review requires a minimum of a rating. * **rating**: Integer value from 1 to 6 with the new rating given. **Required**.   ####Response: The response is a review object containing information about the review.  * **reviewId**: The Id of the created review. * **status**: Status of the created review. Can be 'PENDING', 'PUBLISHED' or 'WITHHELD'. After a successful creation, 'PENDING' is returned. * **links**: A series of links where to get details of the created review;  Example curl: ``` curl -H \"Content-Type: application/json\" -X POST -d ' {     \"reservationId\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",     \"description\": \"Some description of the review\",     \"rating\": 1 } ```  Example response: ``` {     \"reviewId\": \"01a53b36-3f48-11e5-a151-feff819cdc9f\",     \"status\": \"PENDING\",     \"links\": [{         \"href\": \"http://localhost:39250/v1/reviews/01a53b36-3f48-11e5-a151-feff819cdc9f\",         \"method\": \"GET\",         \"rel\": \"get-review\"     }] } ```
+    # @param body Review for this reservation
+    # @param [Hash] opts the optional parameters
+    # @return [ChangedReviewDto]
+    def create_review1(body, opts = {})
+      data, _status_code, _headers = create_review1_with_http_info(body, opts)
+      data
+    end
+
+    # Create a review for a reservation
+    # This resource manages the creation of reviews for a particular agent and a reservation. Reviews must have a description, rating and a reservation public identifier. The agent must be the one that created the reservation, otherwise it is forbidden.  ####Request: The request needs to have 3 parameters for review reviewId, description and rating.  * **reservationId**: Public ID of the reservation where to add a review. **Required**. * **description**: Text content of the review to be set. Optional. A review requires a minimum of a rating. * **rating**: Integer value from 1 to 6 with the new rating given. **Required**.   ####Response: The response is a review object containing information about the review.  * **reviewId**: The Id of the created review. * **status**: Status of the created review. Can be 'PENDING', 'PUBLISHED' or 'WITHHELD'. After a successful creation, 'PENDING' is returned. * **links**: A series of links where to get details of the created review;  Example curl: ``` curl -H \"Content-Type: application/json\" -X POST -d ' {     \"reservationId\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",     \"description\": \"Some description of the review\",     \"rating\": 1 } ```  Example response: ``` {     \"reviewId\": \"01a53b36-3f48-11e5-a151-feff819cdc9f\",     \"status\": \"PENDING\",     \"links\": [{         \"href\": \"http://localhost:39250/v1/reviews/01a53b36-3f48-11e5-a151-feff819cdc9f\",         \"method\": \"GET\",         \"rel\": \"get-review\"     }] } ```
+    # @param body Review for this reservation
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ChangedReviewDto, Fixnum, Hash)>] ChangedReviewDto data, response status code and response headers
+    def create_review1_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ReviewsApi.create_review1 ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling ReviewsApi.create_review1"
+      end
+      # resource path
+      local_var_path = '/v1/reviews'
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(body)
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ChangedReviewDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ReviewsApi#create_review1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get details for a specific review
+    # This resource return details from reviews upon request. The result obtained depends on whether the agent is the owner of the reservation that owns the review or not.  * If the user owns the reservation of the requested review, a detailed review is returned with all the information shown below. * If the user does not own the reservation of the requested review, a simplified review is returned with only the values marked below. * If the user does not own the reservation of the requested review AND the review is in a 'WITHHELD' status, an empty review is returned.   ####Request: The request needs 1 path parameter, the review ID to get details from.  * **reviewId**: ID of the review to get the details from. **Required**.   ####Response: The response is a user review object containing information about the review depending on whether the agent used is the owner of the review or not. The different outcomes are **detailed** if the agent owns the review or **simplified** if not.  * **reviewId**: review UUID. Same as the one used in the request. * **rating**: rating associated to this review. * **description**: description of the review. * **status**: current review status. Possible values are 'PENDING', 'WITHHELD', 'PUBLISHED'. * **merchantId**: merchant id associated to this review. **Only in the detailed view**. * **customerId**: customer id associated to this review. **DEPPRECATED, NOT USED**. * **publicCustomerId**: public customer id associated to this review. **Only in the detailed view**. * **customerFirstName**: review associated customer first name. **Only in the detailed view**. * **customerLastName**: first character of the customer last name. **Only in the detailed view**. * **customerProfileImage**: customer profile image URL. **Only in the detailed view**. * **locale**: locale associated to the review. **Only in the detailed view**.  Example curl: ``` curl https://{host}/v{X}/reviews/07f53b36-3f48-11e5-a151-feff819cdc9f ```  Example response: ``` {     \"reviewId\": \"01a53b36-3f48-11e5-a151-feff819cdc9f\",     \"status\": \"PUBLISHED\",     \"description\": \"Description of the review\",     \"rating\": 3 } ```
+    # @param review_id Review reviewId (UUID) to get details from
+    # @param [Hash] opts the optional parameters
+    # @return [GetReviewDto]
+    def get_review1(review_id, opts = {})
+      data, _status_code, _headers = get_review1_with_http_info(review_id, opts)
+      data
+    end
+
+    # Get details for a specific review
+    # This resource return details from reviews upon request. The result obtained depends on whether the agent is the owner of the reservation that owns the review or not.  * If the user owns the reservation of the requested review, a detailed review is returned with all the information shown below. * If the user does not own the reservation of the requested review, a simplified review is returned with only the values marked below. * If the user does not own the reservation of the requested review AND the review is in a &#39;WITHHELD&#39; status, an empty review is returned.   ####Request: The request needs 1 path parameter, the review ID to get details from.  * **reviewId**: ID of the review to get the details from. **Required**.   ####Response: The response is a user review object containing information about the review depending on whether the agent used is the owner of the review or not. The different outcomes are **detailed** if the agent owns the review or **simplified** if not.  * **reviewId**: review UUID. Same as the one used in the request. * **rating**: rating associated to this review. * **description**: description of the review. * **status**: current review status. Possible values are &#39;PENDING&#39;, &#39;WITHHELD&#39;, &#39;PUBLISHED&#39;. * **merchantId**: merchant id associated to this review. **Only in the detailed view**. * **customerId**: customer id associated to this review. **DEPPRECATED, NOT USED**. * **publicCustomerId**: public customer id associated to this review. **Only in the detailed view**. * **customerFirstName**: review associated customer first name. **Only in the detailed view**. * **customerLastName**: first character of the customer last name. **Only in the detailed view**. * **customerProfileImage**: customer profile image URL. **Only in the detailed view**. * **locale**: locale associated to the review. **Only in the detailed view**.  Example curl: &#x60;&#x60;&#x60; curl https://{host}/v{X}/reviews/07f53b36-3f48-11e5-a151-feff819cdc9f &#x60;&#x60;&#x60;  Example response: &#x60;&#x60;&#x60; {     \&quot;reviewId\&quot;: \&quot;01a53b36-3f48-11e5-a151-feff819cdc9f\&quot;,     \&quot;status\&quot;: \&quot;PUBLISHED\&quot;,     \&quot;description\&quot;: \&quot;Description of the review\&quot;,     \&quot;rating\&quot;: 3 } &#x60;&#x60;&#x60;
+    # @param review_id Review reviewId (UUID) to get details from
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetReviewDto, Fixnum, Hash)>] GetReviewDto data, response status code and response headers
+    def get_review1_with_http_info(review_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ReviewsApi.get_review1 ...'
+      end
+      # verify the required parameter 'review_id' is set
+      if @api_client.config.client_side_validation && review_id.nil?
+        fail ArgumentError, "Missing the required parameter 'review_id' when calling ReviewsApi.get_review1"
+      end
+      # resource path
+      local_var_path = '/v1/reviews/{reviewId}'.sub('{' + 'reviewId' + '}', review_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'GetReviewDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ReviewsApi#get_review1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get information from reviews in a list
+    # This resource return a list of reviews. The result obtained depends on the different query parameters provided. It is able to return three different results: * **Reviews associated to an agent:** if neither 'merchantId' nor 'reservationId' query parameters are provided, then the available reviews for the current agent are returned. * **Reviews associated to a merchant:** if the parameter 'merchantId' is provided, all the reviews for the given merchant and agent are provided. The agent is the one associated with the reservations. * **Reviews associated to a reservation:** if the parameter 'reservationId' is provided, all the reviews for the given reservation and agent are provided. The agent is the one associated with the reservation.  **NOTE:** For the second and third cases, the current agent must be the owner of the reservations used to get the reviews. In the specific case of the search by the merchants, the current agent id is the one realated to the reservations associated to the specified merchant's reviews.  ####Request: The request needs 4 optional query parameters. Pagination is controlled by the usage of the 'limit' and 'offset' parameters.  * **limit**: maximum number of results to be returned. Value must be between 1 and 10. Defaults to 10 when unset, malformed or outside bounds. Ignored when 'reservationId' is enabled. * **offset**: sets the starting element to be returned. Defaults to 0 when unset or malformed. Ignored when 'reservationId' is enabled. * **reservationId**: Public ID of the reservation from which to get the reviews. Cannot be used in combination with 'merchantId'. Can be null. Does not consider 'limit' and/or 'offset'. * **merchantId**: ID of the merchant from wich to get the reviews. Cannot be used in combination with 'reservationId'. Can be null.  ####Response: The response is a user review object containing a list of user reviews.  * **size**: the number of reviews retrieved in this request. Can be any positive value between 0 and 10 (the maximum value for limit); * **offset**: echoes the offset value used in the request. Returns 0 in case 'reservationId' is used. * **limit**: echoes the limit value used in the request. Returns 0 in case 'reservationId' is used. * **reviews**: list of reviews retrieved, each review containing the following properties:  * **reviewId**: review UUID. Same as the one used in the request. * **rating**: rating associated to this review. * **description**: description of the review. * **status**: current review status. Possible values are 'PENDING', 'WITHHELD', 'PUBLISHED'. * **merchantId**: merchant id associated to this review. **Only in the detailed view**. * **customerId**: customer id associated to this review. **DEPPRECATED, NOT USED**. * **publicCustomerId**: public customer id associated to this review. **Only in the detailed view**. * **customerFirstName**: review associated customer first name. **Only in the detailed view**. * **customerLastName**: first character of the customer last name. **Only in the detailed view**. * **customerProfileImage**: customer profile image URL. **Only in the detailed view**. * **locale**: locale associated to the review. **Only in the detailed view**.  Example curl: ``` curl https://{host}/v{X}/reviews?merchantId=5124 ```  Example response: ``` {  \"reviews\": [{    \"reviewId\": \"e94c5f9b-e61f-486a-bfa7-48abb1e42f93\",    \"merchantId\": 5124,    \"publicCustomerId\": \"a10fbb9a-df04-407c-9568-2e79bd620b41\",    \"customerFirstName\": \"Perico\",    \"customerLastName\": \"d\",    \"customerProfileImage\": \"http://test.bla\",    \"rating\": 6,    \"description\": \"Description 8\",    \"status\": \"PUBLISHED\",    \"locale\": \"de_DE\"   }, {    \"reviewId\": \"65472403-7968-4ccf-b389-fe7e6e70ee27\",    \"merchantId\": 5124,    \"publicCustomerId\": \"a10fbb9a-df04-407c-9568-2e79bd620b41\",    \"customerFirstName\": \"Perico\",    \"customerLastName\": \"d\",    \"customerProfileImage\": \"http://test.bla\",    \"rating\": 6,    \"description\": \"Description 9\",    \"status\": \"PUBLISHED\",    \"locale\": \"de_DE\"   }  ],  \"size\": 2,  \"offset\": 0,  \"limit\": 10 } ``` 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :merchant_id MerchantId to get the reviews from. Cannot be used in combination with &#39;reservationId&#39;
+    # @option opts [String] :reservation_id Public reservation id to get the reviews from. Cannot be used in combination with &#39;merchantId&#39;. When set, &#39;offset&#39; and &#39;limit&#39; are ignored. All reviews for a reservation are returned.
+    # @option opts [Integer] :offset Skip first n reviews (default to 0)
+    # @option opts [Integer] :limit Max number to retrieve (default to 10)
+    # @return [GetReviewsDto]
+    def get_reviews2(opts = {})
+      data, _status_code, _headers = get_reviews2_with_http_info(opts)
+      data
+    end
+
+    # Get information from reviews in a list
+    # This resource return a list of reviews. The result obtained depends on the different query parameters provided. It is able to return three different results: * **Reviews associated to an agent:** if neither &#39;merchantId&#39; nor &#39;reservationId&#39; query parameters are provided, then the available reviews for the current agent are returned. * **Reviews associated to a merchant:** if the parameter &#39;merchantId&#39; is provided, all the reviews for the given merchant and agent are provided. The agent is the one associated with the reservations. * **Reviews associated to a reservation:** if the parameter &#39;reservationId&#39; is provided, all the reviews for the given reservation and agent are provided. The agent is the one associated with the reservation.  **NOTE:** For the second and third cases, the current agent must be the owner of the reservations used to get the reviews. In the specific case of the search by the merchants, the current agent id is the one realated to the reservations associated to the specified merchant&#39;s reviews.  ####Request: The request needs 4 optional query parameters. Pagination is controlled by the usage of the &#39;limit&#39; and &#39;offset&#39; parameters.  * **limit**: maximum number of results to be returned. Value must be between 1 and 10. Defaults to 10 when unset, malformed or outside bounds. Ignored when &#39;reservationId&#39; is enabled. * **offset**: sets the starting element to be returned. Defaults to 0 when unset or malformed. Ignored when &#39;reservationId&#39; is enabled. * **reservationId**: Public ID of the reservation from which to get the reviews. Cannot be used in combination with &#39;merchantId&#39;. Can be null. Does not consider &#39;limit&#39; and/or &#39;offset&#39;. * **merchantId**: ID of the merchant from wich to get the reviews. Cannot be used in combination with &#39;reservationId&#39;. Can be null.  ####Response: The response is a user review object containing a list of user reviews.  * **size**: the number of reviews retrieved in this request. Can be any positive value between 0 and 10 (the maximum value for limit); * **offset**: echoes the offset value used in the request. Returns 0 in case &#39;reservationId&#39; is used. * **limit**: echoes the limit value used in the request. Returns 0 in case &#39;reservationId&#39; is used. * **reviews**: list of reviews retrieved, each review containing the following properties:  * **reviewId**: review UUID. Same as the one used in the request. * **rating**: rating associated to this review. * **description**: description of the review. * **status**: current review status. Possible values are &#39;PENDING&#39;, &#39;WITHHELD&#39;, &#39;PUBLISHED&#39;. * **merchantId**: merchant id associated to this review. **Only in the detailed view**. * **customerId**: customer id associated to this review. **DEPPRECATED, NOT USED**. * **publicCustomerId**: public customer id associated to this review. **Only in the detailed view**. * **customerFirstName**: review associated customer first name. **Only in the detailed view**. * **customerLastName**: first character of the customer last name. **Only in the detailed view**. * **customerProfileImage**: customer profile image URL. **Only in the detailed view**. * **locale**: locale associated to the review. **Only in the detailed view**.  Example curl: &#x60;&#x60;&#x60; curl https://{host}/v{X}/reviews?merchantId&#x3D;5124 &#x60;&#x60;&#x60;  Example response: &#x60;&#x60;&#x60; {  \&quot;reviews\&quot;: [{    \&quot;reviewId\&quot;: \&quot;e94c5f9b-e61f-486a-bfa7-48abb1e42f93\&quot;,    \&quot;merchantId\&quot;: 5124,    \&quot;publicCustomerId\&quot;: \&quot;a10fbb9a-df04-407c-9568-2e79bd620b41\&quot;,    \&quot;customerFirstName\&quot;: \&quot;Perico\&quot;,    \&quot;customerLastName\&quot;: \&quot;d\&quot;,    \&quot;customerProfileImage\&quot;: \&quot;http://test.bla\&quot;,    \&quot;rating\&quot;: 6,    \&quot;description\&quot;: \&quot;Description 8\&quot;,    \&quot;status\&quot;: \&quot;PUBLISHED\&quot;,    \&quot;locale\&quot;: \&quot;de_DE\&quot;   }, {    \&quot;reviewId\&quot;: \&quot;65472403-7968-4ccf-b389-fe7e6e70ee27\&quot;,    \&quot;merchantId\&quot;: 5124,    \&quot;publicCustomerId\&quot;: \&quot;a10fbb9a-df04-407c-9568-2e79bd620b41\&quot;,    \&quot;customerFirstName\&quot;: \&quot;Perico\&quot;,    \&quot;customerLastName\&quot;: \&quot;d\&quot;,    \&quot;customerProfileImage\&quot;: \&quot;http://test.bla\&quot;,    \&quot;rating\&quot;: 6,    \&quot;description\&quot;: \&quot;Description 9\&quot;,    \&quot;status\&quot;: \&quot;PUBLISHED\&quot;,    \&quot;locale\&quot;: \&quot;de_DE\&quot;   }  ],  \&quot;size\&quot;: 2,  \&quot;offset\&quot;: 0,  \&quot;limit\&quot;: 10 } &#x60;&#x60;&#x60; 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :merchant_id MerchantId to get the reviews from. Cannot be used in combination with &#39;reservationId&#39;
+    # @option opts [String] :reservation_id Public reservation id to get the reviews from. Cannot be used in combination with &#39;merchantId&#39;. When set, &#39;offset&#39; and &#39;limit&#39; are ignored. All reviews for a reservation are returned.
+    # @option opts [Integer] :offset Skip first n reviews
+    # @option opts [Integer] :limit Max number to retrieve
+    # @return [Array<(GetReviewsDto, Fixnum, Hash)>] GetReviewsDto data, response status code and response headers
+    def get_reviews2_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ReviewsApi.get_reviews2 ...'
+      end
+      # resource path
+      local_var_path = '/v1/reviews'
+
+      # query parameters
+      query_params = {}
+      query_params[:'merchantId'] = opts[:'merchant_id'] if !opts[:'merchant_id'].nil?
+      query_params[:'reservationId'] = opts[:'reservation_id'] if !opts[:'reservation_id'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'GetReviewsDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ReviewsApi#get_reviews2\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Updated a review
+    # This resource manages the update of reviews for a given review ID. Description and rating can be updated on a review. The agent must be the one that owns the reservation associated to the review to modify, otherwise a forbidden response is returned.  **NOTE**: Reviews in state 'PUBLISHED' or 'WITHHELD' cannot be updated. Only those in status 'PENDING' are allowed to be updated.  ####Request: The request needs to have 3 parameters for reservation reviewId (public reviewId), description and rating.  * **reviewId**: Id of the review. **Required**. * **description**: Text content of the review. If not set (null value) it won't be considered for update. * **rating**: Integer value from 1 to 6 with the rating given. If not set (null value) it won't be considered for update.  In case both description and rating are set to null, nothing happens to the review: it is not updated and its state remains.  ####Response: The response is a review object containing information about the review.  * **reviewId**: The Id of the updated review. * **status**: Status of the updated review. Can be 'PENDING', 'PUBLISHED' or 'WITHHELD'. Upon a successful update, the status 'PENDING' is returned. * **links**: A series of links where to get details of the updated review.  Example curl: ``` curl -H \"Content-Type: application/json\" -X POST -d ' {     \"reviewId\": \"01a53b36-3f48-11e5-a151-feff819cdc9f\",     \"description\": \"Some updated description for the review\",     \"rating\": 2 } ```  Example response: ``` {     \"reviewId\": \"01a53b36-3f48-11e5-a151-feff819cdc9f\",     \"status\": \"PENDING\",     \"links\": [{         \"href\": \"http://localhost:39250/v1/reviews/01a53b36-3f48-11e5-a151-feff819cdc9f\",         \"method\": \"GET\",         \"rel\": \"get-review\"     }] } ```
+    # @param body Review for this reservation
+    # @param [Hash] opts the optional parameters
+    # @return [ChangedReviewDto]
+    def update_review1(body, opts = {})
+      data, _status_code, _headers = update_review1_with_http_info(body, opts)
+      data
+    end
+
+    # Updated a review
+    # This resource manages the update of reviews for a given review ID. Description and rating can be updated on a review. The agent must be the one that owns the reservation associated to the review to modify, otherwise a forbidden response is returned.  **NOTE**: Reviews in state &#39;PUBLISHED&#39; or &#39;WITHHELD&#39; cannot be updated. Only those in status &#39;PENDING&#39; are allowed to be updated.  ####Request: The request needs to have 3 parameters for reservation reviewId (public reviewId), description and rating.  * **reviewId**: Id of the review. **Required**. * **description**: Text content of the review. If not set (null value) it won&#39;t be considered for update. * **rating**: Integer value from 1 to 6 with the rating given. If not set (null value) it won&#39;t be considered for update.  In case both description and rating are set to null, nothing happens to the review: it is not updated and its state remains.  ####Response: The response is a review object containing information about the review.  * **reviewId**: The Id of the updated review. * **status**: Status of the updated review. Can be &#39;PENDING&#39;, &#39;PUBLISHED&#39; or &#39;WITHHELD&#39;. Upon a successful update, the status &#39;PENDING&#39; is returned. * **links**: A series of links where to get details of the updated review.  Example curl: &#x60;&#x60;&#x60; curl -H \&quot;Content-Type: application/json\&quot; -X POST -d &#39; {     \&quot;reviewId\&quot;: \&quot;01a53b36-3f48-11e5-a151-feff819cdc9f\&quot;,     \&quot;description\&quot;: \&quot;Some updated description for the review\&quot;,     \&quot;rating\&quot;: 2 } &#x60;&#x60;&#x60;  Example response: &#x60;&#x60;&#x60; {     \&quot;reviewId\&quot;: \&quot;01a53b36-3f48-11e5-a151-feff819cdc9f\&quot;,     \&quot;status\&quot;: \&quot;PENDING\&quot;,     \&quot;links\&quot;: [{         \&quot;href\&quot;: \&quot;http://localhost:39250/v1/reviews/01a53b36-3f48-11e5-a151-feff819cdc9f\&quot;,         \&quot;method\&quot;: \&quot;GET\&quot;,         \&quot;rel\&quot;: \&quot;get-review\&quot;     }] } &#x60;&#x60;&#x60;
+    # @param body Review for this reservation
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ChangedReviewDto, Fixnum, Hash)>] ChangedReviewDto data, response status code and response headers
+    def update_review1_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ReviewsApi.update_review1 ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling ReviewsApi.update_review1"
+      end
+      # resource path
+      local_var_path = '/v1/reviews'
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(body)
+      auth_names = ['API_TOKEN']
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ChangedReviewDto')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ReviewsApi#update_review1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/quandoo/api/status_api.rb

@@ -0,0 +1,111 @@
+=begin
+#Quandoo API Documentation
+
+#No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.5
+
+=end
+
+require 'uri'
+
+module Quandoo
+  class StatusApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Provides information on the status of the service
+    # 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_status_by_get1(opts = {})
+      get_status_by_get1_with_http_info(opts)
+      nil
+    end
+
+    # Provides information on the status of the service
+    # 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def get_status_by_get1_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: StatusApi.get_status_by_get1 ...'
+      end
+      # resource path
+      local_var_path = '/v1/status'
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: StatusApi#get_status_by_get1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Provides information on the status of the service
+    # 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_status_by_head1(opts = {})
+      get_status_by_head1_with_http_info(opts)
+      nil
+    end
+
+    # Provides information on the status of the service
+    # 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def get_status_by_head1_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: StatusApi.get_status_by_head1 ...'
+      end
+      # resource path
+      local_var_path = '/v1/status'
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:HEAD, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: StatusApi#get_status_by_head1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/quandoo/api/validations_api.rb

@@ -0,0 +1,76 @@
+=begin
+#Quandoo API Documentation
+
+#No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.5
+
+=end
+
+require 'uri'
+
+module Quandoo
+  class ValidationsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Validate phone number
+    # This endpoint validates a phone number.  If optional 2-letter country code `country` is not specified, the `phoneNumber` should be formatted according to E164, which means it is expected to be in the international format with a leading `\"+\"` and no spaces or dashes, e.g. `+4930120765890`. Otherwise it may have leading zero instead of country code, e.g. `030120765890`.  The endpoint will return a status `HTTP 200` which means the `phoneNumber` is successfully validated. The endpoint will return a status `HTTP 400` which means the `phoneNumber` is missing or invalid.  Example curl: ``` curl https://{host}/v{X}/validations/phone-numbers?phoneNumber=030120765890&country=IT ```  Example response: ``` {   \"errorMessage\": \"phoneNumber is invalid: 030120765890, country specified is: IT\",   \"errorType\": \"PHONE_NUMBER_INVALID\" } ``` 
+    # @param phone_number Phone number
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :country Country code
+    # @return [nil]
+    def validate_phone_number1(phone_number, opts = {})
+      validate_phone_number1_with_http_info(phone_number, opts)
+      nil
+    end
+
+    # Validate phone number
+    # This endpoint validates a phone number.  If optional 2-letter country code `country` is not specified, the `phoneNumber` should be formatted according to E164, which means it is expected to be in the international format with a leading `\"+\"` and no spaces or dashes, e.g. `+4930120765890`. Otherwise it may have leading zero instead of country code, e.g. `030120765890`.  The endpoint will return a status `HTTP 200` which means the `phoneNumber` is successfully validated. The endpoint will return a status `HTTP 400` which means the `phoneNumber` is missing or invalid.  Example curl: ``` curl https://{host}/v{X}/validations/phone-numbers?phoneNumber=030120765890&country=IT ```  Example response: ``` {   \"errorMessage\": \"phoneNumber is invalid: 030120765890, country specified is: IT\",   \"errorType\": \"PHONE_NUMBER_INVALID\" } ``` 
+    # @param phone_number Phone number
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :country Country code
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def validate_phone_number1_with_http_info(phone_number, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ValidationsApi.validate_phone_number1 ...'
+      end
+      # verify the required parameter 'phone_number' is set
+      if @api_client.config.client_side_validation && phone_number.nil?
+        fail ArgumentError, "Missing the required parameter 'phone_number' when calling ValidationsApi.validate_phone_number1"
+      end
+      # resource path
+      local_var_path = '/v1/validations/phone-numbers'
+
+      # query parameters
+      query_params = {}
+      query_params[:'phoneNumber'] = phone_number
+      query_params[:'country'] = opts[:'country'] if !opts[:'country'].nil?
+
+      # header parameters
+      header_params = {}
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = []
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ValidationsApi#validate_phone_number1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/quandoo/api_client.rb

@@ -0,0 +1,389 @@
+=begin
+#Quandoo API Documentation
+
+#No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.5
+
+=end
+
+require 'date'
+require 'json'
+require 'logger'
+require 'tempfile'
+require 'typhoeus'
+require 'uri'
+
+module Quandoo
+  class ApiClient
+    # The Configuration object holding settings to be used in the API client.
+    attr_accessor :config
+
+    # Defines the headers to be used in HTTP requests of all API calls by default.
+    #
+    # @return [Hash]
+    attr_accessor :default_headers
+
+    # Initializes the ApiClient
+    # @option config [Configuration] Configuration for initializing the object, default to Configuration.default
+    def initialize(config = Configuration.default)
+      @config = config
+      @user_agent = "Swagger-Codegen/#{VERSION}/ruby"
+      @default_headers = {
+        'Content-Type' => 'application/json',
+        'User-Agent' => @user_agent
+      }
+    end
+
+    def self.default
+      @@default ||= ApiClient.new
+    end
+
+    # Call an API with given options.
+    #
+    # @return [Array<(Object, Fixnum, Hash)>] an array of 3 elements:
+    #   the data deserialized from response body (could be nil), response status code and response headers.
+    def call_api(http_method, path, opts = {})
+      request = build_request(http_method, path, opts)
+      response = request.run
+
+      if @config.debugging
+        @config.logger.debug "HTTP response body ~BEGIN~\n#{response.body}\n~END~\n"
+      end
+
+      unless response.success?
+        if response.timed_out?
+          fail ApiError.new('Connection timed out')
+        elsif response.code == 0
+          # Errors from libcurl will be made visible here
+          fail ApiError.new(:code => 0,
+                            :message => response.return_message)
+        else
+          fail ApiError.new(:code => response.code,
+                            :response_headers => response.headers,
+                            :response_body => response.body),
+               response.status_message
+        end
+      end
+
+      if opts[:return_type]
+        data = deserialize(response, opts[:return_type])
+      else
+        data = nil
+      end
+      return data, response.code, response.headers
+    end
+
+    # Builds the HTTP request
+    #
+    # @param [String] http_method HTTP method/verb (e.g. POST)
+    # @param [String] path URL path (e.g. /account/new)
+    # @option opts [Hash] :header_params Header parameters
+    # @option opts [Hash] :query_params Query parameters
+    # @option opts [Hash] :form_params Query parameters
+    # @option opts [Object] :body HTTP body (JSON/XML)
+    # @return [Typhoeus::Request] A Typhoeus Request
+    def build_request(http_method, path, opts = {})
+      url = build_request_url(path)
+      http_method = http_method.to_sym.downcase
+
+      header_params = @default_headers.merge(opts[:header_params] || {})
+      query_params = opts[:query_params] || {}
+      form_params = opts[:form_params] || {}
+
+      update_params_for_auth! header_params, query_params, opts[:auth_names]
+
+      # set ssl_verifyhosts option based on @config.verify_ssl_host (true/false)
+      _verify_ssl_host = @config.verify_ssl_host ? 2 : 0
+
+      req_opts = {
+        :method => http_method,
+        :headers => header_params,
+        :params => query_params,
+        :params_encoding => @config.params_encoding,
+        :timeout => @config.timeout,
+        :ssl_verifypeer => @config.verify_ssl,
+        :ssl_verifyhost => _verify_ssl_host,
+        :sslcert => @config.cert_file,
+        :sslkey => @config.key_file,
+        :verbose => @config.debugging
+      }
+
+      # set custom cert, if provided
+      req_opts[:cainfo] = @config.ssl_ca_cert if @config.ssl_ca_cert
+
+      if [:post, :patch, :put, :delete].include?(http_method)
+        req_body = build_request_body(header_params, form_params, opts[:body])
+        req_opts.update :body => req_body
+        if @config.debugging
+          @config.logger.debug "HTTP request body param ~BEGIN~\n#{req_body}\n~END~\n"
+        end
+      end
+
+      request = Typhoeus::Request.new(url, req_opts)
+      download_file(request) if opts[:return_type] == 'File'
+      request
+    end
+
+    # Check if the given MIME is a JSON MIME.
+    # JSON MIME examples:
+    #   application/json
+    #   application/json; charset=UTF8
+    #   APPLICATION/JSON
+    #   */*
+    # @param [String] mime MIME
+    # @return [Boolean] True if the MIME is application/json
+    def json_mime?(mime)
+      (mime == '*/*') || !(mime =~ /Application\/.*json(?!p)(;.*)?/i).nil?
+    end
+
+    # Deserialize the response to the given return type.
+    #
+    # @param [Response] response HTTP response
+    # @param [String] return_type some examples: "User", "Array[User]", "Hash[String,Integer]"
+    def deserialize(response, return_type)
+      body = response.body
+
+      # handle file downloading - return the File instance processed in request callbacks
+      # note that response body is empty when the file is written in chunks in request on_body callback
+      return @tempfile if return_type == 'File'
+
+      return nil if body.nil? || body.empty?
+
+      # return response body directly for String return type
+      return body if return_type == 'String'
+
+      # ensuring a default content type
+      content_type = response.headers['Content-Type'] || 'application/json'
+
+      fail "Content-Type is not supported: #{content_type}" unless json_mime?(content_type)
+
+      begin
+        data = JSON.parse("[#{body}]", :symbolize_names => true)[0]
+      rescue JSON::ParserError => e
+        if %w(String Date DateTime).include?(return_type)
+          data = body
+        else
+          raise e
+        end
+      end
+
+      convert_to_type data, return_type
+    end
+
+    # Convert data to the given return type.
+    # @param [Object] data Data to be converted
+    # @param [String] return_type Return type
+    # @return [Mixed] Data in a particular type
+    def convert_to_type(data, return_type)
+      return nil if data.nil?
+      case return_type
+      when 'String'
+        data.to_s
+      when 'Integer'
+        data.to_i
+      when 'Float'
+        data.to_f
+      when 'BOOLEAN'
+        data == true
+      when 'DateTime'
+        # parse date time (expecting ISO 8601 format)
+        DateTime.parse data
+      when 'Date'
+        # parse date time (expecting ISO 8601 format)
+        Date.parse data
+      when 'Object'
+        # generic object (usually a Hash), return directly
+        data
+      when /\AArray<(.+)>\z/
+        # e.g. Array<Pet>
+        sub_type = $1
+        data.map { |item| convert_to_type(item, sub_type) }
+      when /\AHash\<String, (.+)\>\z/
+        # e.g. Hash<String, Integer>
+        sub_type = $1
+        {}.tap do |hash|
+          data.each { |k, v| hash[k] = convert_to_type(v, sub_type) }
+        end
+      else
+        # models, e.g. Pet
+        Quandoo.const_get(return_type).new.tap do |model|
+          model.build_from_hash data
+        end
+      end
+    end
+
+    # Save response body into a file in (the defined) temporary folder, using the filename
+    # from the "Content-Disposition" header if provided, otherwise a random filename.
+    # The response body is written to the file in chunks in order to handle files which
+    # size is larger than maximum Ruby String or even larger than the maximum memory a Ruby
+    # process can use.
+    #
+    # @see Configuration#temp_folder_path
+    def download_file(request)
+      tempfile = nil
+      encoding = nil
+      request.on_headers do |response|
+        content_disposition = response.headers['Content-Disposition']
+        if content_disposition && content_disposition =~ /filename=/i
+          filename = content_disposition[/filename=['"]?([^'"\s]+)['"]?/, 1]
+          prefix = sanitize_filename(filename)
+        else
+          prefix = 'download-'
+        end
+        prefix = prefix + '-' unless prefix.end_with?('-')
+        encoding = response.body.encoding
+        tempfile = Tempfile.open(prefix, @config.temp_folder_path, encoding: encoding)
+        @tempfile = tempfile
+      end
+      request.on_body do |chunk|
+        chunk.force_encoding(encoding)
+        tempfile.write(chunk)
+      end
+      request.on_complete do |response|
+        tempfile.close
+        @config.logger.info "Temp file written to #{tempfile.path}, please copy the file to a proper folder "\
+                            "with e.g. `FileUtils.cp(tempfile.path, '/new/file/path')` otherwise the temp file "\
+                            "will be deleted automatically with GC. It's also recommended to delete the temp file "\
+                            "explicitly with `tempfile.delete`"
+      end
+    end
+
+    # Sanitize filename by removing path.
+    # e.g. ../../sun.gif becomes sun.gif
+    #
+    # @param [String] filename the filename to be sanitized
+    # @return [String] the sanitized filename
+    def sanitize_filename(filename)
+      filename.gsub(/.*[\/\\]/, '')
+    end
+
+    def build_request_url(path)
+      # Add leading and trailing slashes to path
+      path = "/#{path}".gsub(/\/+/, '/')
+      URI.encode(@config.base_url + path)
+    end
+
+    # Builds the HTTP request body
+    #
+    # @param [Hash] header_params Header parameters
+    # @param [Hash] form_params Query parameters
+    # @param [Object] body HTTP body (JSON/XML)
+    # @return [String] HTTP body data in the form of string
+    def build_request_body(header_params, form_params, body)
+      # http form
+      if header_params['Content-Type'] == 'application/x-www-form-urlencoded' ||
+          header_params['Content-Type'] == 'multipart/form-data'
+        data = {}
+        form_params.each do |key, value|
+          case value
+          when ::File, ::Array, nil
+            # let typhoeus handle File, Array and nil parameters
+            data[key] = value
+          else
+            data[key] = value.to_s
+          end
+        end
+      elsif body
+        data = body.is_a?(String) ? body : body.to_json
+      else
+        data = nil
+      end
+      data
+    end
+
+    # Update hearder and query params based on authentication settings.
+    #
+    # @param [Hash] header_params Header parameters
+    # @param [Hash] query_params Query parameters
+    # @param [String] auth_names Authentication scheme name
+    def update_params_for_auth!(header_params, query_params, auth_names)
+      Array(auth_names).each do |auth_name|
+        auth_setting = @config.auth_settings[auth_name]
+        next unless auth_setting
+        case auth_setting[:in]
+        when 'header' then header_params[auth_setting[:key]] = auth_setting[:value]
+        when 'query'  then query_params[auth_setting[:key]] = auth_setting[:value]
+        else fail ArgumentError, 'Authentication token must be in `query` of `header`'
+        end
+      end
+    end
+
+    # Sets user agent in HTTP header
+    #
+    # @param [String] user_agent User agent (e.g. swagger-codegen/ruby/1.0.0)
+    def user_agent=(user_agent)
+      @user_agent = user_agent
+      @default_headers['User-Agent'] = @user_agent
+    end
+
+    # Return Accept header based on an array of accepts provided.
+    # @param [Array] accepts array for Accept
+    # @return [String] the Accept header (e.g. application/json)
+    def select_header_accept(accepts)
+      return nil if accepts.nil? || accepts.empty?
+      # use JSON when present, otherwise use all of the provided
+      json_accept = accepts.find { |s| json_mime?(s) }
+      json_accept || accepts.join(',')
+    end
+
+    # Return Content-Type header based on an array of content types provided.
+    # @param [Array] content_types array for Content-Type
+    # @return [String] the Content-Type header  (e.g. application/json)
+    def select_header_content_type(content_types)
+      # use application/json by default
+      return 'application/json' if content_types.nil? || content_types.empty?
+      # use JSON when present, otherwise use the first one
+      json_content_type = content_types.find { |s| json_mime?(s) }
+      json_content_type || content_types.first
+    end
+
+    # Convert object (array, hash, object, etc) to JSON string.
+    # @param [Object] model object to be converted into JSON string
+    # @return [String] JSON string representation of the object
+    def object_to_http_body(model)
+      return model if model.nil? || model.is_a?(String)
+      local_body = nil
+      if model.is_a?(Array)
+        local_body = model.map { |m| object_to_hash(m) }
+      else
+        local_body = object_to_hash(model)
+      end
+      local_body.to_json
+    end
+
+    # Convert object(non-array) to hash.
+    # @param [Object] obj object to be converted into JSON string
+    # @return [String] JSON string representation of the object
+    def object_to_hash(obj)
+      if obj.respond_to?(:to_hash)
+        obj.to_hash
+      else
+        obj
+      end
+    end
+
+    # Build parameter value according to the given collection format.
+    # @param [String] collection_format one of :csv, :ssv, :tsv, :pipes and :multi
+    def build_collection_param(param, collection_format)
+      case collection_format
+      when :csv
+        param.join(',')
+      when :ssv
+        param.join(' ')
+      when :tsv
+        param.join("\t")
+      when :pipes
+        param.join('|')
+      when :multi
+        # return the array directly as typhoeus will handle it as expected
+        param
+      else
+        fail "unknown collection format: #{collection_format.inspect}"
+      end
+    end
+  end
+end