Class: MajesticSeo::Api::Client
- Inherits:
-
Object
- Object
- MajesticSeo::Api::Client
- Includes:
- Logger
- Defined in:
- lib/majestic_seo/api/client.rb
Instance Attribute Summary collapse
-
#api_url ⇒ Object
Returns the value of attribute api_url.
-
#connection ⇒ Object
Returns the value of attribute connection.
Instance Method Summary collapse
-
#execute_command(name, parameters = {}, options = {}) ⇒ Object
This method will execute the specified command as an api request.
-
#execute_open_app_request(command_name, access_token, parameters = {}, options = {}) ⇒ Object
This will execute the specified command as an OpenApp request.
-
#execute_request(parameters = {}, options = {}, retries = 3) ⇒ Object
‘parameters’ a hash containing the command parameters.
- #get_index_item_info(urls, parameters = {}, options = {}) ⇒ Object
- #get_top_back_links(url, parameters = {}, options = {}) ⇒ Object
-
#initialize ⇒ Client
constructor
A new instance of Client.
- #set_api_url(format = :json) ⇒ Object
- #set_connection ⇒ Object
Methods included from Logger
Constructor Details
#initialize ⇒ Client
Returns a new instance of Client.
8 9 10 11 |
# File 'lib/majestic_seo/api/client.rb', line 8 def initialize set_api_url set_connection end |
Instance Attribute Details
#api_url ⇒ Object
Returns the value of attribute api_url.
5 6 7 |
# File 'lib/majestic_seo/api/client.rb', line 5 def api_url @api_url end |
#connection ⇒ Object
Returns the value of attribute connection.
5 6 7 |
# File 'lib/majestic_seo/api/client.rb', line 5 def connection @connection end |
Instance Method Details
#execute_command(name, parameters = {}, options = {}) ⇒ Object
This method will execute the specified command as an api request. ‘name’ is the name of the command you wish to execute, e.g. GetIndexItemInfo ‘parameters’ a hash containing the command parameters. ‘timeout’ specifies the amount of time to wait before aborting the transaction. This defaults to 5 seconds.
71 72 73 74 |
# File 'lib/majestic_seo/api/client.rb', line 71 def execute_command(name, parameters = {}, = {}) request_parameters = parameters.merge({"app_api_key" => ::MajesticSeoApi.configuration.api_key, "cmd" => name}) self.execute_request(request_parameters, ) end |
#execute_open_app_request(command_name, access_token, parameters = {}, options = {}) ⇒ Object
This will execute the specified command as an OpenApp request. ‘command_name’ is the name of the command you wish to execute, e.g. GetIndexItemInfo ‘parameters’ a hash containing the command parameters. ‘access_token’ the token provided by the user to access their resources. ‘timeout’ specifies the amount of time to wait before aborting the transaction. This defaults to 5 seconds.
81 82 83 84 |
# File 'lib/majestic_seo/api/client.rb', line 81 def execute_open_app_request(command_name, access_token, parameters = {}, = {}) request_parameters = parameters.merge({"accesstoken" => access_token, "cmd" => command_name, "privatekey" => ::MajesticSeoApi.configuration.api_key}) self.execute_request(request_parameters, ) end |
#execute_request(parameters = {}, options = {}, retries = 3) ⇒ Object
‘parameters’ a hash containing the command parameters. ‘options’ a hash containing command/call options (timeout, proxy settings etc)
88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 |
# File 'lib/majestic_seo/api/client.rb', line 88 def execute_request(parameters = {}, = {}, retries = 3) response = nil timeout = .delete(:timeout) { |opt| 60 } open_timeout = .delete(:open_timeout) { |opt| 60 } begin log(:info, "[MajesticSeo::Api::Client] - Sending API Request to Majestic SEO. Parameters: #{parameters.inspect}. Options: #{.inspect}") response = self.connection.get do |request| request.params = parameters if !parameters.empty? request. = if !.empty? request.[:timeout] = timeout request.[:open_timeout] = open_timeout end rescue Faraday::Error => e log(:error, "[MajesticSeo::Api::Client] - Error occurred while trying to perform API-call with parameters: #{parameters.inspect}. Error Class: #{e.class.name}. Error Message: #{e.}. Stacktrace: #{e.backtrace.join("\n")}") retries -= 1 if retries > 0 retry else raise e end end return response end |
#get_index_item_info(urls, parameters = {}, options = {}) ⇒ Object
32 33 34 35 36 37 38 39 40 41 42 43 44 45 |
# File 'lib/majestic_seo/api/client.rb', line 32 def get_index_item_info(urls, parameters = {}, = {}) request_parameters = {} request_parameters['datasource'] = parameters.fetch(:data_source, "historic") request_parameters["items"] = urls.size urls.each_with_index do |url, index| request_parameters["item#{index}"] = url end response = self.execute_command("GetIndexItemInfo", request_parameters, ) response = MajesticSeo::Api::ItemInfoResponse.new(response) return response end |
#get_top_back_links(url, parameters = {}, options = {}) ⇒ Object
47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 |
# File 'lib/majestic_seo/api/client.rb', line 47 def get_top_back_links(url, parameters = {}, = {}) raise "Not implemented yet!" request_parameters = {} request_parameters['datasource'] = parameters.fetch(:data_source, "historic") request_parameters['URL'] = url request_parameters["MaxSourceURLs"] = parameters.fetch(:max_source_urls, 100) request_parameters["ShowDomainInfo"] = parameters.fetch(:show_domain_info, 0) request_parameters["GetUrlData"] = parameters.fetch(:get_url_data, 1) request_parameters["GetSubDomainData"] = parameters.fetch(:get_sub_domain_data, 0) request_parameters["GetRootDomainData"] = parameters.fetch(:get_root_domain_data, 0) request_parameters["MaxSourceURLsPerRefDomain"] = parameters.fetch(:max_source_urls_per_ref_domain, -1) request_parameters["DebugForceQueue"] = parameters.fetch(:debug_force_queue, 0) #response = self.execute_command("GetTopBackLinks", request_parameters, options) #response = MajesticSeo::Api::TopBackLinksResponse.new(response) #return response end |
#set_api_url(format = :json) ⇒ Object
13 14 15 16 17 18 19 20 |
# File 'lib/majestic_seo/api/client.rb', line 13 def set_api_url(format = :json) self.api_url = case ::MajesticSeoApi.configuration.environment.to_sym when :sandbox then "http://developer.majestic.com/api/#{format}" when :production then "http://api.majestic.com/api/#{format}" else "http://developer.majestic.com/api/#{format}" end end |
#set_connection ⇒ Object
22 23 24 25 26 27 28 29 30 |
# File 'lib/majestic_seo/api/client.rb', line 22 def set_connection self.connection = Faraday.new(url: self.api_url, ssl: {verify: false}) do |builder| builder.request :url_encoded builder.request :retry builder.response :json builder.response :logger if ::MajesticSeoApi.configuration.verbose builder.adapter :net_http end end |