growwer 1.0.0

data/lib/growwer/api/managed_services_api.rb

@@ -0,0 +1,625 @@
+=begin
+#Growwer API
+
+#The Growwer customer API. Authenticate every call with an API key created on your profile page, sent as `Authorization: Bearer <key>`. A read key can call every GET operation; writes need a read and write key and an `Idempotency-Key` header.  Idempotency: use a new `Idempotency-Key` (1 to 255 printable ASCII characters without spaces) for each operation and reuse it only to retry that same operation. Keys belong to your account, not to one API key. - A successful write is stored for 30 days: a retry with the same key and   the same request replays its response with `Idempotent-Replayed: true`   and does nothing again. - A refused write (4xx) has no effect and releases its key: once you fix the   cause, retry with the same key and the write runs. - A failed write (5xx) may have taken effect, so it is never run again under   its key: a retry gets 409 `idempotency_outcome_unknown`. Check whether it   took effect before retrying with a new key. - A retry while the first request is still running gets 409   `idempotency_request_in_progress`. A request still running after 5 minutes   is treated as failed: a retry gets 409 `idempotency_outcome_unknown`. - The same key with a different request (method, path, query or body) gets   409 `idempotency_key_reused`. A write without the header gets 400   `idempotency_key_required`.  Every response carries `X-Request-Id`. Errors share one shape, `{code, message, requestId, details?}`. Money is integer cents plus a currency code and dates are ISO-8601. 
+
+The version of the OpenAPI document: 1
+Contact: support@growwer.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.24.0
+
+=end
+
+require 'cgi'
+
+module Growwer
+  class ManagedServicesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Estimate accepting proposals
+    # Totals the campaign's accepted proposals that still await their order and the `proposed` ones you name in `accept`, and compares the total with your wallet's available balance. Each proposal counts at its `currentPrice`, or at its `proposedPrice` when the media no longer offers the service. Nothing is accepted, charged or reserved, so a read-only key may call it and it takes no Idempotency-Key.  The estimate is advisory: accepting a proposal charges nothing. The team charges your wallet when it places the order for an accepted proposal, and the same balance pays for the orders you place yourself.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [ManagedServiceProposalsEstimateRequest] :managed_service_proposals_estimate_request 
+    # @return [ManagedServiceProposalsEstimate]
+    def estimate_managed_service_proposals(id, opts = {})
+      data, _status_code, _headers = estimate_managed_service_proposals_with_http_info(id, opts)
+      data
+    end
+
+    # Estimate accepting proposals
+    # Totals the campaign&#39;s accepted proposals that still await their order and the &#x60;proposed&#x60; ones you name in &#x60;accept&#x60;, and compares the total with your wallet&#39;s available balance. Each proposal counts at its &#x60;currentPrice&#x60;, or at its &#x60;proposedPrice&#x60; when the media no longer offers the service. Nothing is accepted, charged or reserved, so a read-only key may call it and it takes no Idempotency-Key.  The estimate is advisory: accepting a proposal charges nothing. The team charges your wallet when it places the order for an accepted proposal, and the same balance pays for the orders you place yourself.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [ManagedServiceProposalsEstimateRequest] :managed_service_proposals_estimate_request 
+    # @return [Array<(ManagedServiceProposalsEstimate, Integer, Hash)>] ManagedServiceProposalsEstimate data, response status code and response headers
+    def estimate_managed_service_proposals_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.estimate_managed_service_proposals ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ManagedServicesApi.estimate_managed_service_proposals"
+      end
+      # resource path
+      local_var_path = '/api/v1/managed-service/campaigns/{id}/proposals/estimate'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'managed_service_proposals_estimate_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ManagedServiceProposalsEstimate'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.estimate_managed_service_proposals",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#estimate_managed_service_proposals\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a managed service campaign
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [ManagedServiceCampaign]
+    def get_managed_service_campaign(id, opts = {})
+      data, _status_code, _headers = get_managed_service_campaign_with_http_info(id, opts)
+      data
+    end
+
+    # Get a managed service campaign
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ManagedServiceCampaign, Integer, Hash)>] ManagedServiceCampaign data, response status code and response headers
+    def get_managed_service_campaign_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.get_managed_service_campaign ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ManagedServicesApi.get_managed_service_campaign"
+      end
+      # resource path
+      local_var_path = '/api/v1/managed-service/campaigns/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ManagedServiceCampaign'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.get_managed_service_campaign",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#get_managed_service_campaign\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Download the summary of a campaign's proposals
+    # The PDF the campaign page offers: the proposals awaiting your review, accepted or being published, newest first, in your language. With `extended=true` it also shows each proposal's price, the price it was proposed at (`proposedPrice`).
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :extended Whether to show the prices. (default to 'false')
+    # @return [File]
+    def get_managed_service_proposals_summary(id, opts = {})
+      data, _status_code, _headers = get_managed_service_proposals_summary_with_http_info(id, opts)
+      data
+    end
+
+    # Download the summary of a campaign&#39;s proposals
+    # The PDF the campaign page offers: the proposals awaiting your review, accepted or being published, newest first, in your language. With &#x60;extended&#x3D;true&#x60; it also shows each proposal&#39;s price, the price it was proposed at (&#x60;proposedPrice&#x60;).
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :extended Whether to show the prices. (default to 'false')
+    # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
+    def get_managed_service_proposals_summary_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.get_managed_service_proposals_summary ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ManagedServicesApi.get_managed_service_proposals_summary"
+      end
+      allowable_values = ["true", "false"]
+      if @api_client.config.client_side_validation && opts[:'extended'] && !allowable_values.include?(opts[:'extended'])
+        fail ArgumentError, "invalid value for \"extended\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v1/managed-service/campaigns/{id}/proposals-summary'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'extended'] = opts[:'extended'] if !opts[:'extended'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/pdf', 'application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'File'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.get_managed_service_proposals_summary",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#get_managed_service_proposals_summary\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List your managed service campaigns
+    # The campaigns your managed service runs for you, newest first. Without a managed service the list is empty: GET /me says whether you have one.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Campaigns per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Campaigns to skip. (default to 0)
+    # @return [ListManagedServiceCampaigns200Response]
+    def list_managed_service_campaigns(opts = {})
+      data, _status_code, _headers = list_managed_service_campaigns_with_http_info(opts)
+      data
+    end
+
+    # List your managed service campaigns
+    # The campaigns your managed service runs for you, newest first. Without a managed service the list is empty: GET /me says whether you have one.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Campaigns per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Campaigns to skip. (default to 0)
+    # @return [Array<(ListManagedServiceCampaigns200Response, Integer, Hash)>] ListManagedServiceCampaigns200Response data, response status code and response headers
+    def list_managed_service_campaigns_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.list_managed_service_campaigns ...'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ManagedServicesApi.list_managed_service_campaigns, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ManagedServicesApi.list_managed_service_campaigns, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling ManagedServicesApi.list_managed_service_campaigns, must be greater than or equal to 0.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/managed-service/campaigns'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListManagedServiceCampaigns200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.list_managed_service_campaigns",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#list_managed_service_campaigns\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the proposals of a campaign
+    # The medias the team proposes for the campaign, newest first. Those `proposed` await your review (POST /managed-service/campaigns/{id}/proposals/review).
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :state Only proposals in these states, comma-separated: &#x60;proposed&#x60;, &#x60;accepted&#x60;, &#x60;cancelled&#x60;, &#x60;purchase_started&#x60;, &#x60;purchase_finished&#x60;.
+    # @option opts [Integer] :limit Proposals per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Proposals to skip. (default to 0)
+    # @return [ListManagedServiceProposals200Response]
+    def list_managed_service_proposals(id, opts = {})
+      data, _status_code, _headers = list_managed_service_proposals_with_http_info(id, opts)
+      data
+    end
+
+    # List the proposals of a campaign
+    # The medias the team proposes for the campaign, newest first. Those &#x60;proposed&#x60; await your review (POST /managed-service/campaigns/{id}/proposals/review).
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :state Only proposals in these states, comma-separated: &#x60;proposed&#x60;, &#x60;accepted&#x60;, &#x60;cancelled&#x60;, &#x60;purchase_started&#x60;, &#x60;purchase_finished&#x60;.
+    # @option opts [Integer] :limit Proposals per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Proposals to skip. (default to 0)
+    # @return [Array<(ListManagedServiceProposals200Response, Integer, Hash)>] ListManagedServiceProposals200Response data, response status code and response headers
+    def list_managed_service_proposals_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.list_managed_service_proposals ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ManagedServicesApi.list_managed_service_proposals"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ManagedServicesApi.list_managed_service_proposals, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ManagedServicesApi.list_managed_service_proposals, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling ManagedServicesApi.list_managed_service_proposals, must be greater than or equal to 0.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/managed-service/campaigns/{id}/proposals'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'state'] = opts[:'state'] if !opts[:'state'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListManagedServiceProposals200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.list_managed_service_proposals",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#list_managed_service_proposals\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Request a new campaign
+    # Asks your account manager for a new campaign, as the managed service page does: the team emails you to agree on it. For accounts with a managed service (GET /me `managedService.active`); without one, POST /managed-service/info-requests asks about the service.  You may send 5 such requests per UTC day through the API. Past them it answers 429 `managed_service_request_limit_reached`, with `Retry-After` the time to the next UTC midnight. A request that is refused (4xx) does not count; one that fails on the server (5xx) does, as it may have been sent.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param managed_service_request [ManagedServiceRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [ManagedServiceRequestSent]
+    def request_managed_service_campaign(idempotency_key, managed_service_request, opts = {})
+      data, _status_code, _headers = request_managed_service_campaign_with_http_info(idempotency_key, managed_service_request, opts)
+      data
+    end
+
+    # Request a new campaign
+    # Asks your account manager for a new campaign, as the managed service page does: the team emails you to agree on it. For accounts with a managed service (GET /me &#x60;managedService.active&#x60;); without one, POST /managed-service/info-requests asks about the service.  You may send 5 such requests per UTC day through the API. Past them it answers 429 &#x60;managed_service_request_limit_reached&#x60;, with &#x60;Retry-After&#x60; the time to the next UTC midnight. A request that is refused (4xx) does not count; one that fails on the server (5xx) does, as it may have been sent.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param managed_service_request [ManagedServiceRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ManagedServiceRequestSent, Integer, Hash)>] ManagedServiceRequestSent data, response status code and response headers
+    def request_managed_service_campaign_with_http_info(idempotency_key, managed_service_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.request_managed_service_campaign ...'
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling ManagedServicesApi.request_managed_service_campaign"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling ManagedServicesApi.request_managed_service_campaign, the character length must be smaller than or equal to 255.'
+      end
+
+      # verify the required parameter 'managed_service_request' is set
+      if @api_client.config.client_side_validation && managed_service_request.nil?
+        fail ArgumentError, "Missing the required parameter 'managed_service_request' when calling ManagedServicesApi.request_managed_service_campaign"
+      end
+      # resource path
+      local_var_path = '/api/v1/managed-service/campaign-requests'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(managed_service_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ManagedServiceRequestSent'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.request_managed_service_campaign",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#request_managed_service_campaign\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Ask about the managed service
+    # Asks the team about the managed service for your website, as the managed service landing page does: the team contacts you. For accounts without a managed service (GET /me `managedService.active`); with one, POST /managed-service/campaign-requests requests a new campaign.  You may send 5 such requests per UTC day through the API. Past them it answers 429 `managed_service_request_limit_reached`, with `Retry-After` the time to the next UTC midnight. A request that is refused (4xx) does not count; one that fails on the server (5xx) does, as it may have been sent.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param managed_service_request [ManagedServiceRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [ManagedServiceRequestSent]
+    def request_managed_service_info(idempotency_key, managed_service_request, opts = {})
+      data, _status_code, _headers = request_managed_service_info_with_http_info(idempotency_key, managed_service_request, opts)
+      data
+    end
+
+    # Ask about the managed service
+    # Asks the team about the managed service for your website, as the managed service landing page does: the team contacts you. For accounts without a managed service (GET /me &#x60;managedService.active&#x60;); with one, POST /managed-service/campaign-requests requests a new campaign.  You may send 5 such requests per UTC day through the API. Past them it answers 429 &#x60;managed_service_request_limit_reached&#x60;, with &#x60;Retry-After&#x60; the time to the next UTC midnight. A request that is refused (4xx) does not count; one that fails on the server (5xx) does, as it may have been sent.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param managed_service_request [ManagedServiceRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ManagedServiceRequestSent, Integer, Hash)>] ManagedServiceRequestSent data, response status code and response headers
+    def request_managed_service_info_with_http_info(idempotency_key, managed_service_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.request_managed_service_info ...'
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling ManagedServicesApi.request_managed_service_info"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling ManagedServicesApi.request_managed_service_info, the character length must be smaller than or equal to 255.'
+      end
+
+      # verify the required parameter 'managed_service_request' is set
+      if @api_client.config.client_side_validation && managed_service_request.nil?
+        fail ArgumentError, "Missing the required parameter 'managed_service_request' when calling ManagedServicesApi.request_managed_service_info"
+      end
+      # resource path
+      local_var_path = '/api/v1/managed-service/info-requests'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(managed_service_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ManagedServiceRequestSent'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.request_managed_service_info",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#request_managed_service_info\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Accept or reject proposals
+    # Decides on every proposal of the campaign that awaits your review (`state` `proposed`), as the campaign page does: name each one once, with `accept` or `reject`, and a comment for the team to reject one. Their order in the body does not matter. Accepting charges nothing: the team places the orders for the accepted proposals and your wallet pays for them then. POST /managed-service/campaigns/{id}/proposals/estimate says what they would cost.  When every proposal is accepted the campaign moves to `proposal_accepted`; when one is rejected the team is told and prepares others. A proposal someone else moved on the campaign page while the request ran is answered in the state it reached.
+    # @param id [String] 
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param managed_service_proposal_review_request [ManagedServiceProposalReviewRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [ManagedServiceProposalReview]
+    def review_managed_service_proposals(id, idempotency_key, managed_service_proposal_review_request, opts = {})
+      data, _status_code, _headers = review_managed_service_proposals_with_http_info(id, idempotency_key, managed_service_proposal_review_request, opts)
+      data
+    end
+
+    # Accept or reject proposals
+    # Decides on every proposal of the campaign that awaits your review (&#x60;state&#x60; &#x60;proposed&#x60;), as the campaign page does: name each one once, with &#x60;accept&#x60; or &#x60;reject&#x60;, and a comment for the team to reject one. Their order in the body does not matter. Accepting charges nothing: the team places the orders for the accepted proposals and your wallet pays for them then. POST /managed-service/campaigns/{id}/proposals/estimate says what they would cost.  When every proposal is accepted the campaign moves to &#x60;proposal_accepted&#x60;; when one is rejected the team is told and prepares others. A proposal someone else moved on the campaign page while the request ran is answered in the state it reached.
+    # @param id [String] 
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param managed_service_proposal_review_request [ManagedServiceProposalReviewRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ManagedServiceProposalReview, Integer, Hash)>] ManagedServiceProposalReview data, response status code and response headers
+    def review_managed_service_proposals_with_http_info(id, idempotency_key, managed_service_proposal_review_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ManagedServicesApi.review_managed_service_proposals ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ManagedServicesApi.review_managed_service_proposals"
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling ManagedServicesApi.review_managed_service_proposals"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling ManagedServicesApi.review_managed_service_proposals, the character length must be smaller than or equal to 255.'
+      end
+
+      # verify the required parameter 'managed_service_proposal_review_request' is set
+      if @api_client.config.client_side_validation && managed_service_proposal_review_request.nil?
+        fail ArgumentError, "Missing the required parameter 'managed_service_proposal_review_request' when calling ManagedServicesApi.review_managed_service_proposals"
+      end
+      # resource path
+      local_var_path = '/api/v1/managed-service/campaigns/{id}/proposals/review'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(managed_service_proposal_review_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ManagedServiceProposalReview'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"ManagedServicesApi.review_managed_service_proposals",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ManagedServicesApi#review_managed_service_proposals\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end