# GoW Official API!

**URL:** <https://community.gemsofwar.com/t/gow-official-api/18365>\
**Category:** Community Guides\
**Created:** [January 15, 2017, 5:15pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365 "2017-01-15T17:15:14Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![SamboyGaming](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/samboygaming/32/17228_2.png) [@SamboyGaming](https://community.gemsofwar.com/u/SamboyGaming)\
**Post date:** [January 15, 2017, 5:15pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/1 "2017-01-15T17:15:14Z")

</div>

EDIT (Sirrian):

I’ve removed the body of this message, as tinkering with the API is not something we want to promote on our forums, since it’s the first step on the path to bots & hacks, and quite likely that you’ll get banned (permanently), unless you’re quite savvy about how APIs work.

 ![](https://us1.discourse-cdn.com/flex019/uploads/gemsofwar/original/3X/c/5/c5216ad34076411561571266425283d16e101c6a.gif)

## _VERY IMPORTANT: WARNING._\*

**TLDR:** Don’t use the API - it’s a VERY bad idea. You’ll likely get banned if you experiment.

As Nimhain mentioned to Samboy… we HIGHLY RECOMMEND not attemnpting to use the API. This API is not of the “friendly” type set up for external users. We have plans to add one of those a little later.  
Any improper or incorrect use of this API can very easily result in automated account banning. There is no appeal process for this… no exceptions. Even if something works TODAY, we may change it, and at that point, incorrect calls may trigger an account ban.  
Furthermore, any use of a 3rd party tool or website to access trhis API has the potential to steal your account information, which may then be used to take or hack your account

---

<div class="post-metadata">

**Author:** ![MrSnake](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/mrsnake/32/4196_2.png) [@MrSnake](https://community.gemsofwar.com/u/MrSnake)\
**Post date:** [January 15, 2017, 5:23pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/2 "2017-01-15T17:23:58Z")

</div>

Nice job Sam…

Same with Krystara the Community Discord Bot^^

---

<div class="post-metadata">

**Author:** ![SamboyGaming](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/samboygaming/32/17228_2.png) [@SamboyGaming](https://community.gemsofwar.com/u/SamboyGaming)\
**Post date:** [January 15, 2017, 5:24pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/3 "2017-01-15T17:24:38Z")

</div>

Thanks! I felt I needed to share this with the community.

---

<div class="post-metadata">

**Author:** ![nolbin](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/nolbin/32/18540_2.png) [@nolbin](https://community.gemsofwar.com/u/nolbin)\
**Post date:** [January 15, 2017, 5:35pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/4 "2017-01-15T17:35:57Z")

</div>

Good job sam

---

<div class="post-metadata">

**Author:** ![Jainus](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/jainus/32/34949_2.png) [@Jainus](https://community.gemsofwar.com/u/Jainus)\
**Post date:** [January 15, 2017, 5:44pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/5 "2017-01-15T17:44:29Z")

</div>

Good job, whatever all this means… I got as far as “some quirks, including perma-banning the account and IP address used if the data supplied is incorrect” and thought yeah this isn’t for me…

---

<div class="post-metadata">

**Author:** ![SamboyGaming](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/samboygaming/32/17228_2.png) [@SamboyGaming](https://community.gemsofwar.com/u/SamboyGaming)\
**Post date:** [January 15, 2017, 5:45pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/6 "2017-01-15T17:45:30Z")

</div>

It’ll only do that if you don’t follow the instructions properly. And make the same error ~10 times in a row, by thinking “Hey, why isn’t this working? I know, I’ll just try again, instead of trying to do something meaningful!”

---

<div class="post-metadata">

**Author:** ![Razzagor](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/razzagor/32/50037_2.png) [@Razzagor](https://community.gemsofwar.com/u/Razzagor)\
**Post date:** [January 15, 2017, 5:52pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/7 "2017-01-15T17:52:13Z")

</div>

But, but, but… it is of “common user” _knowledge_ that clicking at something or repeating the same stuff over and over eventually will make it _work_…

Maaaan… computers so hard… 😉😆

---

<div class="post-metadata">

**Author:** ![SamboyGaming](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/samboygaming/32/17228_2.png) [@SamboyGaming](https://community.gemsofwar.com/u/SamboyGaming)\
**Post date:** [January 15, 2017, 5:54pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/8 "2017-01-15T17:54:34Z")

</div>

It really does annoy me when people think that spam-clicking something is going to help, and then when you go in and open, say, 3 windows to diagnose it (the program, a browser and task manager for example) they’re like “OMG you’re going to make it really slow with that much stuff open!”. Forget computers, PEOPLE are hard!

---

<div class="post-metadata">

**Author:** ![Rasper](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/rasper/32/2363_2.png) [@Rasper](https://community.gemsofwar.com/u/Rasper)\
**Post date:** [January 15, 2017, 6:06pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/9 "2017-01-15T18:06:55Z")

</div>

> [@SamboyGaming](#):
>
> Forget computers, PEOPLE are hard!

^^^ This is the most honest thing I’ve ever read.

---

<div class="post-metadata">

**Author:** ![Rasper](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/rasper/32/2363_2.png) [@Rasper](https://community.gemsofwar.com/u/Rasper)\
**Post date:** [January 15, 2017, 6:27pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/10 "2017-01-15T18:27:58Z")

</div>

So, if I’m reading this correctly, first you do the authentication using a username/password which gives you a token (not sure how you get the token out of the body of the response, or if the entire body IS the token). Then you make another call as get\_hero\_profile with the player’s invite code to get “stuff”.

Does the invite code have to match who is logged in? I’m guessing not since you said that the server token isn’t currently required. It would be ideal if it doesn’t, so a website wouldn’t need a user to give their game login info to have the website get their collection data, only the invite code.

Any specifics on what type of data is returned?

---

<div class="post-metadata">

**Author:** ![MrSnake](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/mrsnake/32/4196_2.png) [@MrSnake](https://community.gemsofwar.com/u/MrSnake)\
**Post date:** [January 15, 2017, 6:30pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/11 "2017-01-15T18:30:06Z")

</div>

when i am correct it is JSON format

---

<div class="post-metadata">

**Author:** ![SamboyGaming](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/samboygaming/32/17228_2.png) [@SamboyGaming](https://community.gemsofwar.com/u/SamboyGaming)\
**Post date:** [January 15, 2017, 7:13pm UTC](https://community.gemsofwar.com/t/gow-official-api/18365/12 "2017-01-15T19:13:41Z")

</div>

Rasper. The token is the response body, then the “result” object, then just simply “ServerToken”. The invite code does NOT have to match the currently signed in user - the data for the currently signed-in user is returned along with the server token in a block called “pUser”. And yes, it’s JSON format, which is why it says that in the docs.

---

<div class="post-metadata">

**Author:** ![Sirrian](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/sirrian/32/35758_2.png) [@Sirrian](https://community.gemsofwar.com/u/Sirrian)\
**Post date:** [January 16, 2017, 12:03am UTC](https://community.gemsofwar.com/t/gow-official-api/18365/13 "2017-01-16T00:03:54Z")

</div>



---

<div class="post-metadata">

**Author:** ![Sirrian](https://sea1.discourse-cdn.com/flex019/user_avatar/community.gemsofwar.com/sirrian/32/35758_2.png) [@Sirrian](https://community.gemsofwar.com/u/Sirrian)\
**Post date:** [January 16, 2017, 12:06am UTC](https://community.gemsofwar.com/t/gow-official-api/18365/14 "2017-01-16T00:06:16Z")

</div>

Sorry to be a killjoy, folks, but we can’t have a thread like this on our official forums… you can share what you like privately, and mess around with stuff… but we can’t officially promote tools to get people banned so easily… it creates a nightmare for our support guys dealing with it.
