###SharprWowApi SharprWowApi is a strongly typed .NET wrapper library for accessing Blizzards WoW API.

Install using Nuget

PM> Install-Package SharprWowApi

Small example website

Usage example

#####Get achievement By ID

var client = ApiClient(Region.Eu, Locale.en_GB, ApiKey.Value);
var achievement = client.GetAchievement(2144);
Console.WriteLine(achievement.Title);

#####Get Character by realm and name

var client = new ApiClient(Region.EU, Locale.en_GB, ApiKey.Value);

var characterOne = client.GetCharacter("CharacterName", CharacterOptions.None, "Realm");
var characterTwo = client.GetCharacter("CharacterName", CharacterOptions.PvP, "Realm");

Console.WriteLine(character.Name);
Console.WriteLine(character.Pvp.Brackets.ArenaBracket2v2.Rating);

You can also set realm in the ApiClient and use extention methods if all characters you're getting are from the same realm.

client = new ApiClient(Region.EU, Locale.en_GB, ApiKey.Value, "Realm");

var characterOne = client.GetCharacter("CharacterName", CharacterOptions.None);
var characterTwo = client.GetCharacter("CharacterName", CharacterOptions.None);
var characterThree = client.GetCharacter("CharacterName", CharacterOptions.None);

Console.WriteLine(characterOne.Name);
Console.WriteLine(characterTwo.Name);
Console.WriteLine(characterThree.Name);

#####Create your own Guild & CharacterOptions (v1.0.2) Can be useful if you need to retrieve more than a single field but less than all.

var options = GuildOptions.Members | GuildOptions.Challenge;
var guild = client.GetGuild("GuildName", options, "Realm");
...

####Usage example ASP.NET MVC Returns a strongly typed GuildRoot object to the view.

using SharprWowApi.Models.Guild;

public ActionResult Members()
{
    var client = new ApiClient(Region.EU, Locale.en_GB, ApiKey.Value, "Realm");
    var guild = client.GetGuild("GuildName", GuildOptions.AllOptions);
    
    return View(guild);
}

@model SharprWowApi.Models.Guild.GuildRoot

<div class="tab-ctrl" id="tabCtrl">
    <div id="page1" class="main-page">
    
       @foreach (var member in Model.Members.OrderByDescending(m => m.Character.Class))
        {
                Do something
        }
...

#####Async Since some of the data returned by blizzards wow API is quite big (especially auction data & PVP leaderboard), it can be a good idea to use the async methods even though the json parsing is not async. Since it offloads the json deserialization to a new thread. (JamesNK/Newtonsoft.Json#66).

And even though the deserialization isn't async it stills downloads the json asynchronously.

var client = new ApiClientAsync(Region.EU, Locale.en_GB, ApiKey.Value);

//await
var getAuctionFile = await client.GetAuctionFileAsync("Realm");
var someCachedValue = "...";

//Check when the auctiondata was last modified (updated)
var lm = from f in getAuctionFile.Files
            select f.LastModified;

  if (!lm.Equals(someCachedValue))
  {
    //await here
    var getAuction = await client.GetAuctionsAsync("Realm");
    var auction = getAuction.Auctions.Auction;
    
  using (auction.GetEnumerator())
  {
       Parallel.ForEach(auction, a =>
       {
         Console.WriteLine(a.Item);
       });
  }
 ...

####Get all members from a guild as Character objects (1.1) An signifcant speed increase compared to a synchronous operation. It's worth noting that if you try to parse a guild with too many members (without setting how many members to take to a low enough number) and the amount of requests to the api gets too high, you will get a 403 (forbidden) error.

Both test cases used the same list of (64) members. They both Get Character (GetCharacterAsync & GetCharacter) and adds the result to a list.

var client = new ApiClientAsync(Region,Locale, apiKey)
var guild = await client.GetGuildAsync("GuildName", GuildOptions.Members);

var charc = await 
    client.GetAllCharactersInGuildAsync(guild.Members, 
        CharacterOptions.AllOptions,
        int level, int HowManyMembersToTake);

The method sorts users by level first and then takes the set amount.