hanzoai 8.5.156

data/lib/hanzoai/api/seo_api.rb

@@ -0,0 +1,487 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class SeoApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Fetch one page and report what it gets wrong
+    # Fetches one page and reports what it gets wrong.  It returns the page's on-page score, its title and description, how much readable text it carries, and the full set of named checks — is it https, does it have one h1, is the title duplicated, is it slow, is it a redirect, is anything on it broken. It is the technical half of search visibility, and it is the half a developer can act on this afternoon.  ONE PAGE, LIVE, IN THIS REQUEST. It is deliberately not a site crawl: a crawl is a job with a lifecycle, and this answers the same questions about the page somebody is actually looking at, now, with no task id to poll. Point it at the pages that matter one at a time.  It is priced per page fetched, which is one.
+    # @param seo_audit_in [SeoAuditIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SeoAuditOut]
+    def seo_audit(seo_audit_in, opts = {})
+      data, _status_code, _headers = seo_audit_with_http_info(seo_audit_in, opts)
+      data
+    end
+
+    # Fetch one page and report what it gets wrong
+    # Fetches one page and reports what it gets wrong.  It returns the page's on-page score, its title and description, how much readable text it carries, and the full set of named checks — is it https, does it have one h1, is the title duplicated, is it slow, is it a redirect, is anything on it broken. It is the technical half of search visibility, and it is the half a developer can act on this afternoon.  ONE PAGE, LIVE, IN THIS REQUEST. It is deliberately not a site crawl: a crawl is a job with a lifecycle, and this answers the same questions about the page somebody is actually looking at, now, with no task id to poll. Point it at the pages that matter one at a time.  It is priced per page fetched, which is one.
+    # @param seo_audit_in [SeoAuditIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SeoAuditOut, Integer, Hash)>] SeoAuditOut data, response status code and response headers
+    def seo_audit_with_http_info(seo_audit_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeoApi.seo_audit ...'
+      end
+      # verify the required parameter 'seo_audit_in' is set
+      if @api_client.config.client_side_validation && seo_audit_in.nil?
+        fail ArgumentError, "Missing the required parameter 'seo_audit_in' when calling SeoApi.seo_audit"
+      end
+      # resource path
+      local_var_path = '/v1/seo/audit'
+
+      # 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(seo_audit_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SeoAuditOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SeoApi.seo_audit",
+        :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: SeoApi#seo_audit\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Who links to a target, and how much of it is broken or spam
+    # Summarises who links to a target.  It returns the authority score, how many links point at it and from how many distinct sites, how many of those are broken, and how much of the profile reads as spam. Distinct sites is the number to read: a thousand links from one domain is one endorsement, and a profile that grew fast in links and not in domains is usually a profile somebody bought.  The target can be a whole domain, a subdomain, or one page URL — the summary is scoped to whatever is named. It is priced per request, so a domain with ten million links costs the same as one with ten.
+    # @param seo_backlink_in [SeoBacklinkIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SeoBacklinkOut]
+    def seo_backlink(seo_backlink_in, opts = {})
+      data, _status_code, _headers = seo_backlink_with_http_info(seo_backlink_in, opts)
+      data
+    end
+
+    # Who links to a target, and how much of it is broken or spam
+    # Summarises who links to a target.  It returns the authority score, how many links point at it and from how many distinct sites, how many of those are broken, and how much of the profile reads as spam. Distinct sites is the number to read: a thousand links from one domain is one endorsement, and a profile that grew fast in links and not in domains is usually a profile somebody bought.  The target can be a whole domain, a subdomain, or one page URL — the summary is scoped to whatever is named. It is priced per request, so a domain with ten million links costs the same as one with ten.
+    # @param seo_backlink_in [SeoBacklinkIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SeoBacklinkOut, Integer, Hash)>] SeoBacklinkOut data, response status code and response headers
+    def seo_backlink_with_http_info(seo_backlink_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeoApi.seo_backlink ...'
+      end
+      # verify the required parameter 'seo_backlink_in' is set
+      if @api_client.config.client_side_validation && seo_backlink_in.nil?
+        fail ArgumentError, "Missing the required parameter 'seo_backlink_in' when calling SeoApi.seo_backlink"
+      end
+      # resource path
+      local_var_path = '/v1/seo/backlinks'
+
+      # 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(seo_backlink_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SeoBacklinkOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SeoApi.seo_backlink",
+        :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: SeoApi#seo_backlink\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # The domains that place for the same phrases
+    # Names the domains that place for the same phrases.  Given a set of phrases it returns the sites that appear across them, with each one's average position, how many of the phrases it places for, its share of the available attention and the visits that earns. It answers \"who am I actually up against here\", which is a different question from \"who do I think my competitors are\" and frequently a different answer.  Pair it with seoRank: this says who is in the race, seoRank says where any one of them finishes. It is priced per row, so Limit decides the cost.
+    # @param seo_competitor_in [SeoCompetitorIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SeoCompetitorOut]
+    def seo_competitor(seo_competitor_in, opts = {})
+      data, _status_code, _headers = seo_competitor_with_http_info(seo_competitor_in, opts)
+      data
+    end
+
+    # The domains that place for the same phrases
+    # Names the domains that place for the same phrases.  Given a set of phrases it returns the sites that appear across them, with each one&#39;s average position, how many of the phrases it places for, its share of the available attention and the visits that earns. It answers \&quot;who am I actually up against here\&quot;, which is a different question from \&quot;who do I think my competitors are\&quot; and frequently a different answer.  Pair it with seoRank: this says who is in the race, seoRank says where any one of them finishes. It is priced per row, so Limit decides the cost.
+    # @param seo_competitor_in [SeoCompetitorIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SeoCompetitorOut, Integer, Hash)>] SeoCompetitorOut data, response status code and response headers
+    def seo_competitor_with_http_info(seo_competitor_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeoApi.seo_competitor ...'
+      end
+      # verify the required parameter 'seo_competitor_in' is set
+      if @api_client.config.client_side_validation && seo_competitor_in.nil?
+        fail ArgumentError, "Missing the required parameter 'seo_competitor_in' when calling SeoApi.seo_competitor"
+      end
+      # resource path
+      local_var_path = '/v1/seo/competitors'
+
+      # 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(seo_competitor_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SeoCompetitorOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SeoApi.seo_competitor",
+        :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: SeoApi#seo_competitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Grow a seed phrase into the phrases nobody named yet
+    # Grows a seed phrase into the phrases nobody named yet.  It takes phrases you have and returns phrases in the same category that you do not — relevant rather than merely containing the seed — each with its search volume, click cost, competition and how hard its first page is to reach. This is where a keyword list comes FROM; seoKeyword is where a list you already have gets measured.  It is priced per row, so Limit is the knob that decides what the call costs. Total says how many more there were.
+    # @param seo_idea_in [SeoIdeaIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SeoIdeaOut]
+    def seo_idea(seo_idea_in, opts = {})
+      data, _status_code, _headers = seo_idea_with_http_info(seo_idea_in, opts)
+      data
+    end
+
+    # Grow a seed phrase into the phrases nobody named yet
+    # Grows a seed phrase into the phrases nobody named yet.  It takes phrases you have and returns phrases in the same category that you do not — relevant rather than merely containing the seed — each with its search volume, click cost, competition and how hard its first page is to reach. This is where a keyword list comes FROM; seoKeyword is where a list you already have gets measured.  It is priced per row, so Limit is the knob that decides what the call costs. Total says how many more there were.
+    # @param seo_idea_in [SeoIdeaIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SeoIdeaOut, Integer, Hash)>] SeoIdeaOut data, response status code and response headers
+    def seo_idea_with_http_info(seo_idea_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeoApi.seo_idea ...'
+      end
+      # verify the required parameter 'seo_idea_in' is set
+      if @api_client.config.client_side_validation && seo_idea_in.nil?
+        fail ArgumentError, "Missing the required parameter 'seo_idea_in' when calling SeoApi.seo_idea"
+      end
+      # resource path
+      local_var_path = '/v1/seo/ideas'
+
+      # 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(seo_idea_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SeoIdeaOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SeoApi.seo_idea",
+        :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: SeoApi#seo_idea\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # How often named phrases are searched, and what a click costs
+    # Measures phrases the caller already has.  It answers, for each phrase named, how many people search it in a month, what an advertising click on it costs, and how contested that advertising is. This is the ground fact of search: everything else on this surface is a question about phrases, and this is the one that says whether a phrase is worth having.  Give it phrases you already suspect. To find phrases you have not thought of, use seoIdea; to find the ones a site already places for, use seoRank.  The market defaults to the United States in English. It is priced per request rather than per phrase, so asking about fifty phrases costs what asking about one does.
+    # @param seo_keyword_in [SeoKeywordIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SeoKeywordOut]
+    def seo_keyword(seo_keyword_in, opts = {})
+      data, _status_code, _headers = seo_keyword_with_http_info(seo_keyword_in, opts)
+      data
+    end
+
+    # How often named phrases are searched, and what a click costs
+    # Measures phrases the caller already has.  It answers, for each phrase named, how many people search it in a month, what an advertising click on it costs, and how contested that advertising is. This is the ground fact of search: everything else on this surface is a question about phrases, and this is the one that says whether a phrase is worth having.  Give it phrases you already suspect. To find phrases you have not thought of, use seoIdea; to find the ones a site already places for, use seoRank.  The market defaults to the United States in English. It is priced per request rather than per phrase, so asking about fifty phrases costs what asking about one does.
+    # @param seo_keyword_in [SeoKeywordIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SeoKeywordOut, Integer, Hash)>] SeoKeywordOut data, response status code and response headers
+    def seo_keyword_with_http_info(seo_keyword_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeoApi.seo_keyword ...'
+      end
+      # verify the required parameter 'seo_keyword_in' is set
+      if @api_client.config.client_side_validation && seo_keyword_in.nil?
+        fail ArgumentError, "Missing the required parameter 'seo_keyword_in' when calling SeoApi.seo_keyword"
+      end
+      # resource path
+      local_var_path = '/v1/seo/keywords'
+
+      # 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(seo_keyword_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SeoKeywordOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SeoApi.seo_keyword",
+        :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: SeoApi#seo_keyword\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Every phrase a domain already places for, with its position
+    # Reports every phrase a domain already places for.  For each one it gives the phrase, the position on the results page, the page of the site that placed, that result's headline, the phrase's monthly searches and the visits the placement is estimated to earn. It is the single most direct question about a site's search visibility — yours or a competitor's, since it takes any domain.  Position is the ABSOLUTE rank, counting every element on the page — the ads, the answer boxes, the map — because that is what a person scrolling actually passes. An organic-only rank flatters a result that sits below half a screen of other things.  It is priced per row, so Limit decides what the call costs, and Total says how many more there were.
+    # @param seo_rank_in [SeoRankIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [SeoRankOut]
+    def seo_rank(seo_rank_in, opts = {})
+      data, _status_code, _headers = seo_rank_with_http_info(seo_rank_in, opts)
+      data
+    end
+
+    # Every phrase a domain already places for, with its position
+    # Reports every phrase a domain already places for.  For each one it gives the phrase, the position on the results page, the page of the site that placed, that result&#39;s headline, the phrase&#39;s monthly searches and the visits the placement is estimated to earn. It is the single most direct question about a site&#39;s search visibility — yours or a competitor&#39;s, since it takes any domain.  Position is the ABSOLUTE rank, counting every element on the page — the ads, the answer boxes, the map — because that is what a person scrolling actually passes. An organic-only rank flatters a result that sits below half a screen of other things.  It is priced per row, so Limit decides what the call costs, and Total says how many more there were.
+    # @param seo_rank_in [SeoRankIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SeoRankOut, Integer, Hash)>] SeoRankOut data, response status code and response headers
+    def seo_rank_with_http_info(seo_rank_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeoApi.seo_rank ...'
+      end
+      # verify the required parameter 'seo_rank_in' is set
+      if @api_client.config.client_side_validation && seo_rank_in.nil?
+        fail ArgumentError, "Missing the required parameter 'seo_rank_in' when calling SeoApi.seo_rank"
+      end
+      # resource path
+      local_var_path = '/v1/seo/rankings'
+
+      # 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(seo_rank_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SeoRankOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SeoApi.seo_rank",
+        :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: SeoApi#seo_rank\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # What each call on this surface costs, from the vendor's own list
+    # Publishes what every call on this surface costs.  The numbers are read from the upstream's own published price list, not from a table kept here, so a price change on their side moves this card within the hour and moves what is debited with it. That is the whole of the pricing model: this surface resells at cost, and the cost is theirs to state.  A row has two numbers because a call has two costs: a flat charge for asking, and a charge per row returned. An op priced per request reports zero for the second, and for one priced per row the total is `request + result x limit` — which is the amount your balance is authorized against before the call, and roughly what you will be debited after it.  It is a read and it is free: asking what something costs must not require the balance that would pay for it. If the upstream cannot be reached the card comes back empty rather than stale — a price nobody can confirm is not a price.
+    # @param [Hash] opts the optional parameters
+    # @return [SeoRateOut]
+    def seo_rate(opts = {})
+      data, _status_code, _headers = seo_rate_with_http_info(opts)
+      data
+    end
+
+    # What each call on this surface costs, from the vendor&#39;s own list
+    # Publishes what every call on this surface costs.  The numbers are read from the upstream&#39;s own published price list, not from a table kept here, so a price change on their side moves this card within the hour and moves what is debited with it. That is the whole of the pricing model: this surface resells at cost, and the cost is theirs to state.  A row has two numbers because a call has two costs: a flat charge for asking, and a charge per row returned. An op priced per request reports zero for the second, and for one priced per row the total is &#x60;request + result x limit&#x60; — which is the amount your balance is authorized against before the call, and roughly what you will be debited after it.  It is a read and it is free: asking what something costs must not require the balance that would pay for it. If the upstream cannot be reached the card comes back empty rather than stale — a price nobody can confirm is not a price.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SeoRateOut, Integer, Hash)>] SeoRateOut data, response status code and response headers
+    def seo_rate_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SeoApi.seo_rate ...'
+      end
+      # resource path
+      local_var_path = '/v1/seo/rates'
+
+      # 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] || 'SeoRateOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SeoApi.seo_rate",
+        :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: SeoApi#seo_rate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/hanzoai/api/settings_api.rb

@@ -0,0 +1,159 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class SettingsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Reads the caller org's configuration for one product, with every secret field MASKED — only the names of the set secrets come back, never their values, which live in KMS.
+    # Reads the caller org's configuration for one product, with every secret field MASKED — only the names of the set secrets come back, never their values, which live in KMS. A product the org has never configured is not a 404: it answers 200 with an empty config object, so the console's Settings tab always renders and merges its own display defaults on top.
+    # @param product [String] Product is the catalog slug, from the path. Must match ^[a-z0-9][a-z0-9._-]{0,62}$.
+    # @param [Hash] opts the optional parameters
+    # @return [SettingsView]
+    def get_settings_by_product(product, opts = {})
+      data, _status_code, _headers = get_settings_by_product_with_http_info(product, opts)
+      data
+    end
+
+    # Reads the caller org's configuration for one product, with every secret field MASKED — only the names of the set secrets come back, never their values, which live in KMS.
+    # Reads the caller org's configuration for one product, with every secret field MASKED — only the names of the set secrets come back, never their values, which live in KMS. A product the org has never configured is not a 404: it answers 200 with an empty config object, so the console's Settings tab always renders and merges its own display defaults on top.
+    # @param product [String] Product is the catalog slug, from the path. Must match ^[a-z0-9][a-z0-9._-]{0,62}$.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SettingsView, Integer, Hash)>] SettingsView data, response status code and response headers
+    def get_settings_by_product_with_http_info(product, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SettingsApi.get_settings_by_product ...'
+      end
+      # verify the required parameter 'product' is set
+      if @api_client.config.client_side_validation && product.nil?
+        fail ArgumentError, "Missing the required parameter 'product' when calling SettingsApi.get_settings_by_product"
+      end
+      # resource path
+      local_var_path = '/v1/settings/{product}'.sub('{' + 'product' + '}', CGI.escape(product.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] || 'SettingsView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SettingsApi.get_settings_by_product",
+        :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: SettingsApi#get_settings_by_product\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Writes the caller org's configuration for one product and answers the stored result, secrets masked.
+    # Writes the caller org's configuration for one product and answers the stored result, secrets masked. Secret VALUES are sealed into KMS under orgs/{org}/settings/{product}/{key} and never touch this deployment's database; with no KMS configured a write that carries any secret is refused whole (503) rather than dropping it or persisting it in the clear. A secret the body omits keeps its stored value, so a partial write never silently clears one.
+    # @param product [String] Product is the catalog slug, from the PATH. zip binds the path last, so the URL names the product being written whatever a body field claims.
+    # @param settings_req [SettingsReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [SettingsView]
+    def put_settings_by_product(product, settings_req, opts = {})
+      data, _status_code, _headers = put_settings_by_product_with_http_info(product, settings_req, opts)
+      data
+    end
+
+    # Writes the caller org&#39;s configuration for one product and answers the stored result, secrets masked.
+    # Writes the caller org&#39;s configuration for one product and answers the stored result, secrets masked. Secret VALUES are sealed into KMS under orgs/{org}/settings/{product}/{key} and never touch this deployment&#39;s database; with no KMS configured a write that carries any secret is refused whole (503) rather than dropping it or persisting it in the clear. A secret the body omits keeps its stored value, so a partial write never silently clears one.
+    # @param product [String] Product is the catalog slug, from the PATH. zip binds the path last, so the URL names the product being written whatever a body field claims.
+    # @param settings_req [SettingsReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SettingsView, Integer, Hash)>] SettingsView data, response status code and response headers
+    def put_settings_by_product_with_http_info(product, settings_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SettingsApi.put_settings_by_product ...'
+      end
+      # verify the required parameter 'product' is set
+      if @api_client.config.client_side_validation && product.nil?
+        fail ArgumentError, "Missing the required parameter 'product' when calling SettingsApi.put_settings_by_product"
+      end
+      # verify the required parameter 'settings_req' is set
+      if @api_client.config.client_side_validation && settings_req.nil?
+        fail ArgumentError, "Missing the required parameter 'settings_req' when calling SettingsApi.put_settings_by_product"
+      end
+      # resource path
+      local_var_path = '/v1/settings/{product}'.sub('{' + 'product' + '}', CGI.escape(product.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(settings_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SettingsView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SettingsApi.put_settings_by_product",
+        :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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SettingsApi#put_settings_by_product\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end