Project

d3api

0.0
No commit activity in last 3 years
No release in over 3 years
Diablo 3 API ruby wrapper
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
= 2.12.0
~> 2.4.0

Runtime

~> 0.8.4
~> 10.0.3
 Project Readme

Build Status Code Climate Coverage Status

D3api

This gem is a ruby wrapper to Blizzard's Diablo 3 api.

Installation

Add this line to your application's Gemfile:

gem 'd3api'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install d3api

Usage

All objects are tied to regions. Every api call will require a region to be set. The available list of regions are:

  1. :us
  2. :eu
  3. :kr
  4. :tw
  5. :ch

Career

To get a user's Diablo 3 career, you need to know 3 things:

  1. BattleTag Name
  2. BattleTag Code
  3. Region

Then it's ruby time.

@career = D3api::Career.new(:us, 'yojymbu', '1249')

This will return a Career object with json values. I tried my best to implement nice methods to get through the values such as:

@career.heroes #=> returns an array of heroes 
@career.last_hero_played #=> returns the id of last hero played
@careerlast_updated.
@career.artisans #=> returns a hash of your arisan information
@career.monster_kills #=> returns an integer

There is a ton of data gleaned from the career object. Just look at Blizzard's Diablo 3 api docs for more information. You can also look through the respc tests to get a better idea of what the methods are to utilize.

Hero

To get a user's Diablo 3 hero, you need to know 4 things:

  1. BattleTag Name
  2. BattleTag Code
  3. Region
  4. Hero ID
@hero = D3api::Hero.new :us, 'yojymbu', '1249', '30255685' #=>
returns hero object
@hero.name #=> Returns name of character
@hero.hero_class #=> Returns class of character
@hero.skills #=> returns an array of hashes for active and passive
skills
@hero.items #=> returns an array of hashes

Item

To get an item from Diablo 3, you need 2 things:

  1. Region
  2. Item String
@item = D3api::Item.new :us,
'COGHsoAIEgcIBBXIGEoRHYQRdRUdnWyzFB2qXu51MA04kwNAAFAKYJMD' #=> returns
an item object
@item.name #=> Exsanguinating Chopsword of Assault
@item.icon #=> mightyweapon1h_202

And many more. Please refer to Blizzard's Diablo 3 documentation for more information.

Follower / Artisan Information

You need 2 things:

  1. Region
  2. Follower or Artisan type
@follower = D3pi::Follower.new :us, 'scoundrel'
@artisan = D3api::Artisan.new :us, 'blacksmith'

That's It!

If you have any comments questions or concerns, please let me know.

ToDos

  1. Implement Authentication per Blizzards protocol (allow 10,000 unsigned requests or 50,000 signed requests).

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request