Skip to content
/ EF.RiotApi Public

A .NET library to make calls to and from the RiotApi simpler

9 stars 3 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

efranford/EF.RiotApi

BranchesTags

Repository files navigation

EF.RiotApi

A .NET library to make calls to and from the RiotApi simpler

Simple Steps To Use

Add your api key to the app config in the tests and the main library. If you are using this from NuGet you'll need to add in your app keys to whatever app/web.config you have.

If you don't have a developer key yet you can get one at:

https://developer.riotgames.com/

From there you should be pretty good to go. Just call into RiotWeb to do what you need to.

Now On NuGet!

Grab the latest version at - https://www.nuget.org/packages/EF.RiotApi

Usage:

Check out the tests to see how all the api calls are made.
Here are a few examples:

Example 1: Get summoner id by name

  
var me = EF.RiotApi.Client.RiotWeb.API.Summoner.GetSummoner("Dome");
Console.WriteLine("{0}:{1}", me.Name, me.Id);
  
output: Dome:32144

Example 2: Get recent games


var gamesResult = EF.RiotApi.Client.RiotWeb.API.Game.GetGamesBySummoner(32144);
foreach(var game in gamesResult.Games)
{
    Console.WriteLine("Game {0}", game.GameId);
    Console.WriteLine("MapId={0} ChampionId={1} Mode={2}", game.MapId, game.ChampionId, game.GameMode);
    Console.WriteLine("Players"); 
    foreach (var player in game.FellowPlayers)
    {
        Console.Write("{0}({1}) ", player.SummonerId, player.TeamId == game.TeamId ? "Teammate" : "Opponent");
    }
    Console.WriteLine("\nStats");
    foreach(var stat in game.Statistics)
    {
        Console.Write("{0}={1}", stat.Name, stat.Value);
    }
    Console.WriteLine("\n------------------------------------------------------------");
}


output: 
Game 1172587007
MapId=1 ChampionId=25 Mode=ONEFORALL
Players
40932113(Opponent) 19599827(Teammate) 38102146(Opponent) 32980628(Opponent) 37179199(Opponent) 588100(Teammate) 24072924(Opponent) 42755450(Teammate)
433928(Teammate)
Stats
LEVEL=11GOLD_EARNED=6997NUM_DEATHS=3MINIONS_KILLED=53CHAMPIONS_KILLED=3GOLD_SPENT=4930TOTAL_DAMAGE_DEALT=57444TOTAL_DAMAGE_TAKEN=12206KILLING_SPREES=1
WIN=1LARGEST_KILLING_SPREE=3TEAM=200ITEM4=3020ITEM1=3206NEUTRAL_MINIONS_KILLED=30ITEM0=2003PHYSICAL_DAMAGE_DEALT_PLAYER=10054ITEM3=1027LARGEST_MULTI_K
ILL=1ITEM2=3082TRUE_DAMAGE_DEALT_PLAYER=5144MAGIC_DAMAGE_TAKEN=1108MAGIC_DAMAGE_DEALT_PLAYER=42245PHYSICAL_DAMAGE_DEALT_TO_CHAMPIONS=573TOTAL_DAMAGE_D
EALT_TO_CHAMPIONS=6480PHYSICAL_DAMAGE_TAKEN=11097MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=5906ITEM6=3362TOTAL_HEAL=326TIME_PLAYED=1246NEUTRAL_MINIONS_KILLED_YO
UR_JUNGLE=27TOTAL_TIME_CROWD_CONTROL_DEALT=246NEUTRAL_MINIONS_KILLED_ENEMY_JUNGLE=3TOTAL_UNITS_HEALED=1ASSISTS=5
------------------------------------------------------------
Game 1172619611
MapId=1 ChampionId=115 Mode=ONEFORALL
Players
45429330(Opponent) 46046883(Opponent) 25338388(Opponent) 45344838(Opponent) 23499881(Teammate) 21875238(Teammate) 21881879(Teammate) 29150016(Opponent
) 433928(Teammate)
Stats
LEVEL=16GOLD_EARNED=11806NUM_DEATHS=13BARRACKS_KILLED=1TURRETS_KILLED=1MINIONS_KILLED=141CHAMPIONS_KILLED=1GOLD_SPENT=9930TOTAL_DAMAGE_DEALT=179082TOT
AL_DAMAGE_TAKEN=25857WIN=1ITEM5=3255TEAM=100ITEM4=1056ITEM1=3001NEUTRAL_MINIONS_KILLED=46ITEM0=1011PHYSICAL_DAMAGE_DEALT_PLAYER=20820ITEM3=3174LARGEST
_MULTI_KILL=1ITEM2=3191TRUE_DAMAGE_DEALT_PLAYER=15396MAGIC_DAMAGE_TAKEN=14717MAGIC_DAMAGE_DEALT_PLAYER=142865PHYSICAL_DAMAGE_DEALT_TO_CHAMPIONS=597TOT
AL_DAMAGE_DEALT_TO_CHAMPIONS=15212PHYSICAL_DAMAGE_TAKEN=10681MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=14615ITEM6=3362TOTAL_HEAL=195TIME_PLAYED=2605NEUTRAL_MINI
ONS_KILLED_YOUR_JUNGLE=40TOTAL_TIME_CROWD_CONTROL_DEALT=814WARD_PLACED=11NEUTRAL_MINIONS_KILLED_ENEMY_JUNGLE=6TRUE_DAMAGE_TAKEN=459TOTAL_UNITS_HEALED=
1ASSISTS=6
------------------------------------------------------------
Game 1191145184
MapId=12 ChampionId=38 Mode=ARAM
Players
30820804(Opponent) 30411075(Opponent) 19208325(Teammate) 44570418(Teammate) 47471416(Opponent) 21449399(Teammate) 37073334(Opponent) 433928(Teammate)
42089779(Opponent)
Stats
LEVEL=17GOLD_EARNED=12210NUM_DEATHS=10MINIONS_KILLED=37CHAMPIONS_KILLED=10GOLD_SPENT=8305TOTAL_DAMAGE_DEALT=53603TOTAL_DAMAGE_TAKEN=33208DOUBLE_KILLS=
1KILLING_SPREES=3LARGEST_KILLING_SPREE=3LOSE=1TEAM=100ITEM4=3027ITEM1=3020ITEM0=3027PHYSICAL_DAMAGE_DEALT_PLAYER=6716ITEM3=3027LARGEST_MULTI_KILL=2ITE
M2=3010MAGIC_DAMAGE_TAKEN=19816PHYSICAL_DAMAGE_DEALT_TO_CHAMPIONS=2205MAGIC_DAMAGE_DEALT_PLAYER=46887PHYSICAL_DAMAGE_TAKEN=10813TOTAL_DAMAGE_DEALT_TO_
CHAMPIONS=26267MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=24062TOTAL_HEAL=2581TIME_PLAYED=1509TOTAL_TIME_CROWD_CONTROL_DEALT=438TOTAL_UNITS_HEALED=1TRUE_DAMAGE_T
AKEN=2578ASSISTS=17
------------------------------------------------------------
Game 1172537507
MapId=1 ChampionId=13 Mode=CLASSIC
Players
45880547(Opponent) 35253533(Teammate) 19184825(Teammate) 43082450(Teammate) 39785449(Opponent) 23270592(Opponent) 36483790(Opponent) 433928(Teammate)
19312577(Opponent)
Stats
LEVEL=17GOLD_EARNED=12531NUM_DEATHS=14MINIONS_KILLED=190CHAMPIONS_KILLED=6GOLD_SPENT=10075TOTAL_DAMAGE_DEALT=141725TOTAL_DAMAGE_TAKEN=39588KILLING_SPR
EES=2LARGEST_KILLING_SPREE=2ITEM5=3110LOSE=1TEAM=200ITEM4=3027ITEM1=1031NEUTRAL_MINIONS_KILLED=8ITEM0=3040PHYSICAL_DAMAGE_DEALT_PLAYER=18729ITEM3=3255
LARGEST_MULTI_KILL=1TRUE_DAMAGE_DEALT_PLAYER=90MAGIC_DAMAGE_TAKEN=11443TRUE_DAMAGE_DEALT_TO_CHAMPIONS=90MAGIC_DAMAGE_DEALT_PLAYER=122906PHYSICAL_DAMAG
E_DEALT_TO_CHAMPIONS=1403PHYSICAL_DAMAGE_TAKEN=25396TOTAL_DAMAGE_DEALT_TO_CHAMPIONS=25439MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=23946SIGHT_WARDS_BOUGHT=1ITEM
6=3362TOTAL_HEAL=1187TIME_PLAYED=2408NEUTRAL_MINIONS_KILLED_YOUR_JUNGLE=8TOTAL_TIME_CROWD_CONTROL_DEALT=96WARD_PLACED=6TRUE_DAMAGE_TAKEN=2747TOTAL_UNI
TS_HEALED=1ASSISTS=5
------------------------------------------------------------
Game 1187641649
MapId=1 ChampionId=110 Mode=CLASSIC
Players
21283713(Teammate) 39459926(Opponent) 43360359(Opponent) 32258430(Teammate) 24494697(Teammate) 34966141(Teammate) 24248410(Opponent) 21835559(Opponent
) 34611748(Opponent)
Stats
LEVEL=18GOLD_EARNED=19424NUM_DEATHS=7MINIONS_KILLED=265CHAMPIONS_KILLED=14GOLD_SPENT=14625TOTAL_DAMAGE_DEALT=293640TOTAL_DAMAGE_TAKEN=39148KILLING_SPR
EES=5LARGEST_KILLING_SPREE=3ITEM5=3026LOSE=1TEAM=200ITEM4=3072ITEM1=3035NEUTRAL_MINIONS_KILLED=38ITEM0=3031PHYSICAL_DAMAGE_DEALT_PLAYER=268036ITEM3=32
50LARGEST_MULTI_KILL=1ITEM2=3046TRUE_DAMAGE_DEALT_PLAYER=932MAGIC_DAMAGE_TAKEN=21943TRUE_DAMAGE_DEALT_TO_CHAMPIONS=636MAGIC_DAMAGE_DEALT_PLAYER=24670P
HYSICAL_DAMAGE_DEALT_TO_CHAMPIONS=42143PHYSICAL_DAMAGE_TAKEN=16292TOTAL_DAMAGE_DEALT_TO_CHAMPIONS=50384MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=7604LARGEST_CRI
TICAL_STRIKE=922ITEM6=3362TOTAL_HEAL=4150TIME_PLAYED=2938NEUTRAL_MINIONS_KILLED_YOUR_JUNGLE=32TOTAL_TIME_CROWD_CONTROL_DEALT=569WARD_PLACED=7NEUTRAL_M
INIONS_KILLED_ENEMY_JUNGLE=6TRUE_DAMAGE_TAKEN=912TOTAL_UNITS_HEALED=1ASSISTS=10
------------------------------------------------------------
Game 1187596977
MapId=1 ChampionId=267 Mode=CLASSIC
Players
21971569(Opponent) 38068222(Teammate) 21781281(Opponent) 22302700(Opponent) 37310704(Teammate) 297795(Teammate) 38901566(Opponent) 342673(Teammate) 27
781012(Opponent)
Stats
LEVEL=14GOLD_EARNED=10755NUM_DEATHS=1MINIONS_KILLED=14CHAMPIONS_KILLED=1GOLD_SPENT=7175TOTAL_DAMAGE_DEALT=22151TOTAL_DAMAGE_TAKEN=8616WIN=1ITEM5=3158T
EAM=100ITEM4=2043ITEM1=3069ITEM0=3190PHYSICAL_DAMAGE_DEALT_PLAYER=13758LARGEST_MULTI_KILL=1ITEM2=3222MAGIC_DAMAGE_TAKEN=1393MAGIC_DAMAGE_DEALT_PLAYER=
8393PHYSICAL_DAMAGE_DEALT_TO_CHAMPIONS=2218TOTAL_DAMAGE_DEALT_TO_CHAMPIONS=6776PHYSICAL_DAMAGE_TAKEN=6540VISION_WARDS_BOUGHT=3MAGIC_DAMAGE_DEALT_TO_CH
AMPIONS=4557SIGHT_WARDS_BOUGHT=2ITEM6=3362TOTAL_HEAL=7794TIME_PLAYED=1968TOTAL_TIME_CROWD_CONTROL_DEALT=134WARD_PLACED=17TRUE_DAMAGE_TAKEN=683TOTAL_UN
ITS_HEALED=5WARD_KILLED=2ASSISTS=16
------------------------------------------------------------
Game 1191200943
MapId=12 ChampionId=412 Mode=ARAM
Players
19208325(Teammate) 29310042(Opponent) 40020030(Opponent) 20324477(Opponent) 36341192(Teammate) 46611779(Opponent) 21083754(Teammate) 433928(Teammate)
23662109(Opponent)
Stats
LEVEL=18GOLD_EARNED=13034NUM_DEATHS=12TURRETS_KILLED=2MINIONS_KILLED=17CHAMPIONS_KILLED=10GOLD_SPENT=10855TOTAL_DAMAGE_DEALT=40554TOTAL_DAMAGE_TAKEN=2
5943TRIPLE_KILLS=1DOUBLE_KILLS=1KILLING_SPREES=4WIN=1LARGEST_KILLING_SPREE=3ITEM5=3087TEAM=100ITEM4=3252ITEM1=3092ITEM0=3153PHYSICAL_DAMAGE_DEALT_PLAY
ER=18570ITEM3=3172LARGEST_MULTI_KILL=3ITEM2=2003MAGIC_DAMAGE_TAKEN=16771PHYSICAL_DAMAGE_DEALT_TO_CHAMPIONS=10746MAGIC_DAMAGE_DEALT_PLAYER=21984PHYSICA
L_DAMAGE_TAKEN=9172TOTAL_DAMAGE_DEALT_TO_CHAMPIONS=27155MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=16409LARGEST_CRITICAL_STRIKE=272TOTAL_HEAL=980TIME_PLAYED=1508
TOTAL_TIME_CROWD_CONTROL_DEALT=249TOTAL_UNITS_HEALED=1ASSISTS=30
------------------------------------------------------------
Game 1189144902
MapId=1 ChampionId=110 Mode=CLASSIC
Players
38271744(Opponent) 27716879(Teammate) 25923671(Teammate) 47775822(Opponent) 28571106(Teammate) 47795969(Opponent) 47686053(Opponent) 40373850(Opponent
) 214286(Teammate)
Stats
LEVEL=11GOLD_EARNED=6968NUM_DEATHS=3MINIONS_KILLED=156CHAMPIONS_KILLED=2GOLD_SPENT=5920TOTAL_DAMAGE_DEALT=77503TOTAL_DAMAGE_TAKEN=10522ITEM5=1055LOSE=
1TEAM=100ITEM4=3006NEUTRAL_MINIONS_KILLED=2PHYSICAL_DAMAGE_DEALT_PLAYER=71905ITEM3=3086LARGEST_MULTI_KILL=1ITEM2=3072MAGIC_DAMAGE_TAKEN=4101PHYSICAL_D
AMAGE_DEALT_TO_CHAMPIONS=7349MAGIC_DAMAGE_DEALT_PLAYER=5598TOTAL_DAMAGE_DEALT_TO_CHAMPIONS=8536PHYSICAL_DAMAGE_TAKEN=6420LARGEST_CRITICAL_STRIKE=414MA
GIC_DAMAGE_DEALT_TO_CHAMPIONS=1186ITEM6=3350TOTAL_HEAL=464TIME_PLAYED=1359NEUTRAL_MINIONS_KILLED_YOUR_JUNGLE=2TOTAL_TIME_CROWD_CONTROL_DEALT=147WARD_P
LACED=4TOTAL_UNITS_HEALED=1ASSISTS=3
------------------------------------------------------------
Game 1170768541
MapId=1 ChampionId=64 Mode=CLASSIC
Players
25382933(Opponent) 35949233(Opponent) 31395103(Opponent) 21026232(Teammate) 39690089(Opponent) 23008840(Teammate) 35788983(Opponent) 25185156(Teammate
) 22083113(Teammate)
Stats
LEVEL=11GOLD_EARNED=6799NUM_DEATHS=2MINIONS_KILLED=23CHAMPIONS_KILLED=7GOLD_SPENT=4475TOTAL_DAMAGE_DEALT=73163TOTAL_DAMAGE_TAKEN=13166DOUBLE_KILLS=1KI
LLING_SPREES=2WIN=1LARGEST_KILLING_SPREE=5ITEM5=3111TEAM=200ITEM4=1053ITEM1=1038NEUTRAL_MINIONS_KILLED=52ITEM0=2003PHYSICAL_DAMAGE_DEALT_PLAYER=43120I
TEM3=3044LARGEST_MULTI_KILL=2TRUE_DAMAGE_DEALT_PLAYER=7198MAGIC_DAMAGE_TAKEN=3035TRUE_DAMAGE_DEALT_TO_CHAMPIONS=12MAGIC_DAMAGE_DEALT_PLAYER=22845PHYSI
CAL_DAMAGE_DEALT_TO_CHAMPIONS=4162PHYSICAL_DAMAGE_TAKEN=9888TOTAL_DAMAGE_DEALT_TO_CHAMPIONS=5864MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=1690ITEM6=3350TOTAL_HE
AL=501TIME_PLAYED=1214NEUTRAL_MINIONS_KILLED_YOUR_JUNGLE=38TOTAL_TIME_CROWD_CONTROL_DEALT=604WARD_PLACED=4NEUTRAL_MINIONS_KILLED_ENEMY_JUNGLE=14TRUE_D
AMAGE_TAKEN=242TOTAL_UNITS_HEALED=1ASSISTS=2
------------------------------------------------------------
Game 1187764840
MapId=1 ChampionId=267 Mode=CLASSIC
Players
43092489(Teammate) 35727768(Opponent) 19184825(Teammate) 36477262(Teammate) 37428722(Opponent) 27870964(Opponent) 26361514(Opponent) 24559426(Teammate
) 24253971(Opponent)
Stats
LEVEL=8GOLD_EARNED=5368NUM_DEATHS=2MINIONS_KILLED=9CHAMPIONS_KILLED=2GOLD_SPENT=3940TOTAL_DAMAGE_DEALT=9170TOTAL_DAMAGE_TAKEN=5736DOUBLE_KILLS=1KILLIN
G_SPREES=1LARGEST_KILLING_SPREE=2LOSE=1TEAM=200ITEM1=2003ITEM0=3069PHYSICAL_DAMAGE_DEALT_PLAYER=4570ITEM3=1028LARGEST_MULTI_KILL=2ITEM2=3275MAGIC_DAMA
GE_TAKEN=2233MAGIC_DAMAGE_DEALT_PLAYER=4599PHYSICAL_DAMAGE_DEALT_TO_CHAMPIONS=1851TOTAL_DAMAGE_DEALT_TO_CHAMPIONS=4556PHYSICAL_DAMAGE_TAKEN=3502VISION
_WARDS_BOUGHT=2MAGIC_DAMAGE_DEALT_TO_CHAMPIONS=2705SIGHT_WARDS_BOUGHT=2ITEM6=3340TOTAL_HEAL=4613TIME_PLAYED=1278TOTAL_TIME_CROWD_CONTROL_DEALT=88WARD_
PLACED=11TOTAL_UNITS_HEALED=4ASSISTS=3
------------------------------------------------------------

Compatibility

.NET 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1 Need more? Just ask :)

Caveat->.NET 2.0 & 3.0 do not have asynchrnous operations or Tasks(yet)

FAQ/Gotchas

If you are missing an app.config please add the following in an "app.config" file to both the Tests project as well as lib:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="ApiKey" value="[YOUR KEY HERE]"/>
<add key="ApiUrl" value="https://prod.api.pvp.net/api/lol" />
<add key ="ApiRegion" value="na" />
<add key ="ApiVerision" value="v1.1" />
<add key ="CachingEnabled" value="true" />
</appSettings>
</configuration>

About

A .NET library to make calls to and from the RiotApi simpler

Resources

Readme
Activity

Stars

9 stars

Watchers

6 watching

Forks

3 forks
Report repository

Releases

2 tags

Packages

No packages published

Languages