Class: BlizzardApi::Diablo::Artisan

Inherits:
Request show all
Defined in:
lib/blizzard_api/diablo/community/artisan.rb

Overview

This class allows access to Diablo III artisan data

You can get an instance of this class using the default region as follows:

api_instance = BlizzardApi::Diablo.artisan

See Also:

Constant Summary

Constants inherited from Request

Request::CACHE_DAY, Request::CACHE_HOUR, Request::CACHE_TRIMESTER

Constants included from ApiStandards

ApiStandards::BASE_URLS

Instance Attribute Summary

Attributes inherited from Request

#mode, #region

Instance Method Summary collapse

Methods inherited from Request

#initialize

Methods inherited from Request

#initialize

Constructor Details

This class inherits a constructor from BlizzardApi::Diablo::Request

Instance Method Details

#get(artisan_slug, **options) ⇒ Hash

Return data about an artisan by its slug

in the configuration module

Parameters:

  • artisan_slug (String) —

    Artisan slug

  • options (Hash) —

    You can specify some options

Options Hash (**options):

  • :locale (String) —

    Overrides the default locale for a single call

  • :namespace (String) —

    Overrides the default namespace for a single call

  • :access_token (String) —

    Overrides the access_token for a single call

  • :ignore_cache (Boolean) —

    If set to true the request will not use the cache

  • :ttl (Integer) —

    Override the default time (in seconds) a request should be cached

  • :since (DateTime) —

    Adds the If-modified-since headers. Will always ignore cache when set.

Returns:

  • (Hash) —

    API Response. The actual type of the returned object depends on the format option



20
21
22
 
# File 'lib/blizzard_api/diablo/community/artisan.rb', line 20

def get(artisan_slug, **options)
  api_request "#{base_url(:community)}/data/artisan/#{artisan_slug}", **{ ttl: CACHE_TRIMESTER }.merge(options)
end

#recipe(artisan_slug, recipe_slug, **options) ⇒ Hash

Return data about an artisan recipe

in the configuration module

Parameters:

  • artisan_slug (String) —

    Artisan slug

  • recipe_slug (String) —

    Recipe slug

  • options (Hash) —

    You can specify some options

Options Hash (**options):

  • :locale (String) —

    Overrides the default locale for a single call

  • :namespace (String) —

    Overrides the default namespace for a single call

  • :access_token (String) —

    Overrides the access_token for a single call

  • :ignore_cache (Boolean) —

    If set to true the request will not use the cache

  • :ttl (Integer) —

    Override the default time (in seconds) a request should be cached

  • :since (DateTime) —

    Adds the If-modified-since headers. Will always ignore cache when set.

Returns:

  • (Hash) —

    API Response. The actual type of the returned object depends on the format option



32
33
34
35
 
# File 'lib/blizzard_api/diablo/community/artisan.rb', line 32

def recipe(artisan_slug, recipe_slug, **options)
  opts = { ttl: CACHE_TRIMESTER }.merge(options)
  api_request "#{base_url(:community)}/data/artisan/#{artisan_slug}/recipe/#{recipe_slug}", **opts
end