These forums have been archived and are now read-only.

The new forums are live and can be found at https://forums.eveonline.com/

EVE Technology Lab

 
  • Topic is locked indefinitely.
123Next pageLast page
 

CREST experimental access for the Alliance Tournament

First post First post
Author
Previous Topic Next Topic
CCP QC
C C P
C C P Alliance
#1 - 2013-07-11 11:48:31 UTC  |  Edited by: CCP Logibro
Hi all!

As part of the upcoming Alliance Tournament, we will be making a small section of CREST available publicly. These endpoints do NOT require authentication and do NOT require a special license.

TL;DR: Get yourself a REST style browser plugin and head over to http://public-crest-duality.testeveonline.com/tournaments/

EDIT 2013-07-18:
Public CREST endpoint is now available for TQ. Data is live. Of course, not much will happen until the AT actually start =) Duality is still where you might want to look to see data until we start the AT.
http://public-crest.eveonline.com/tournaments/

Some notes on this:
1) Halp, I clicked your link and my browser downloaded a weird file and I don't know what to do with it!!!
The CREST resources aren't webpages. Due to how we use mediatypes (See 9 below) you will in general need to use a browser plugin to see the data. I use Postman in Chrome ( https://chrome.google.com/webstore/detail/postman-rest-client/fdmmgilgnpjigdojojpjoooidkmcomcm ). Just head to whatever search engine you like and search for "MYBROWSER rest plugin" and you should be fine.

2) What do you aim to get from this experimental access?
I'd like you guys to try it out and let us know what you think of it. Hopefully if this goes well we will be looking into adding other public endpoint to CREST, as we all wait for the full read/write access.

3) Will this endpoint be live past the AT?
Not sure at this point. I hope so.

4) Will this be getting live data during the AT?
Yes, it currently runs on Duality, the AT practice server, but will run on TQ for the actual tournament. Data is sourced directly from the actual game cluster, so data will update in real(ish) time.

5) Does it support write access?
Nope. Public crest will of course never allow write access.

6) What information will be available:
In short: the tournament structure, the teams composition, the match statistics and the per-pilot statistics.

7) Why can't I get to the /xxx/ endpoints?
Currently the access is restricted to /tournaments/*, everything else is going to 404. We will hopefully be lifting some of these restriction after the AT, as we assess how this went.

8) What the hell are all those "_str" fields?!
Whilst JSON does support sending down 64 bit numbers, javascript doesn't play nicely with them. In order to help support Javascript clients, we thus add the "_str" member next to all fields marked as Numbers. Eve has a lot of 64 bit IDs, sometimes appearing in the weirdest of places, so we played it safe. However, we are looking into only returing those extra attributes if requested by the client. More on that later. See: http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf for the gory details on how JS represents Numbers internally.

9) What are those weird Content-Type header values I'm seeing?
CREST transfers resources (a tournament, a team, etc) as versionned representation. These representation are indicated using mediatypes. Requesting /tournaments/1/ will give you a "application/vnd.ccp.eve.Tournament-v1+json". Should we need to make non-backwards compatible changes, we would then introduce "application/vnd.ccp.eve.Tournament-v2+json". The URL wouldn't change, only the content-type and the actual content. Client are free to request whichever version they want using the accept header. (I could add a fake v2 of something under /tournaments/ for you guys to experiment with, if you would like)

10) I'm getting 502 errors!
Very likely the cluster is currently down. Try again later =)

11) I'm getting 503 errors!
You probably requested too fast. Wait a minute and try again. I'll be tweaking throttling parameters over the coming days, so I can't give exact values for this.

Disclaimers: (also edit!)
Please note that we are actively working on the tournaments/* endpoints. They are liable to change with no prior notice. They should also be quite stable before we reach TQ.
CCP FoxFour
C C P
C C P Alliance
#2 - 2013-07-11 11:56:05 UTC
CANNOT LIKE ENOUGH!

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.
Two step
Aperture Harmonics
#3 - 2013-07-11 12:17:26 UTC
Pretty neat stuff, and I am hopeful this is the beginning of the long awaited CREST rollout.... :)

CSM 7 Secretary CSM 6 Alternate Delegate @two_step_eve on Twitter My Blog
Chitsa Jason
Deep Core Mining Inc.
Caldari State
#4 - 2013-07-11 12:19:03 UTC
Its alive!!!

Burn the land and boil the sea You can't take the sky from me
local009
Event Horizon Systems
The-Expanse
#5 - 2013-07-11 12:26:11 UTC
*doing a jiggy jive dance around his work place*

FINALLY something to play with! \o/

*heads back to work....*
HVAC Repairman
Hedion University
Amarr Empire
#6 - 2013-07-11 12:29:25 UTC
didnt want the old API system anyways

Follow me on twitter
Ferria
Outsourced Manufacturing
#7 - 2013-07-11 12:45:25 UTC
so, QC, about Crest, and Dust, and things, anymore info.

On topic, Sweet, thanks
CCP QC
C C P
C C P Alliance
#8 - 2013-07-11 15:43:02 UTC
Ferria wrote:
so, QC, about Crest, and Dust, and things, anymore info.

On topic, Sweet, thanks


I'd say this is the first roll out of CREST. As far as Dust is concerned, I hope to give the Dust devs public crest capability right after the tournament. CCP Nullarbor just can't wait to get his hands on this, so I'd expect some goodies to come soon(ish)
Oxandrolone
Center for Advanced Studies
Gallente Federation
#9 - 2013-07-11 15:48:50 UTC  |  Edited by: Oxandrolone
what type of tools do you think this will enable people to build

(I know only very basic c programming and have absolutely no imagination)

Ones that pull statistics about the tournament maybe?
CCP QC
C C P
C C P Alliance
#10 - 2013-07-11 15:57:56 UTC
Oxandrolone wrote:
what type of tools do you think this will enable people to build

(I know only very basic c programming and have absolutely no imagination)

Ones that pull statistics about the tournament maybe?


Likely something like that. One could pull all the data about a tournament, or a match, and display it. Could also make a tool that fetches what other teams are flying and catalog their setups. Or make an app that queries the prices of stuff people are flying and take bets on how much they'll loose. Sky is the limit.

But really, this is to get some input from devs with respect to the style of API that is CREST. And also to see what happens when I give the world an unrestricted CREST box =)
CCP Nullarbor
C C P
C C P Alliance
#11 - 2013-07-11 15:59:59 UTC
CCP QC wrote:
Ferria wrote:
so, QC, about Crest, and Dust, and things, anymore info.

On topic, Sweet, thanks


I'd say this is the first roll out of CREST. As far as Dust is concerned, I hope to give the Dust devs public crest capability right after the tournament. CCP Nullarbor just can't wait to get his hands on this, so I'd expect some goodies to come soon(ish)


Yes please Big smile

CCP Nullarbor // Senior Engineer // Team Game of Drones
Marcel Devereux
Aideron Robotics
Aideron Robotics.
#12 - 2013-07-11 16:00:20 UTC
Nice way to sneak CREST out! Awesome work guys! I can't wait to see more!
Luigi Thirty
Science and Trade Institute
Caldari State
#13 - 2013-07-11 17:11:05 UTC  |  Edited by: Luigi Thirty
Why are you using your own MIME type instead of application/json? Why are you using nginx 1.2 which has more holes than a golf course?
CCP QC
C C P
C C P Alliance
#14 - 2013-07-11 17:16:56 UTC
Luigi Thirty wrote:
Why are you using your own MIME type instead of application/json? Why are you using nginx 1.2 which has more holes than a golf course?


We use our own mime type to support being asked for different version of a resource by the clients. By sending in an accept header with the correct mimetype, say "application/vnd.eve.ccp.Tournament-v1" the server knows to return you that particular version. It allows us to release new versions of these resource and your client will keep working as long as we support the version you want. Asking the server with an accept header that doesn't match returns you the latest version of a particular resource.

We use our own magical build of nginx, which we are in the process of upgrading to latest =)
Tarsas Phage
Sniggerdly
#15 - 2013-07-11 18:23:58 UTC
CCP QC wrote:
Luigi Thirty wrote:
Why are you using your own MIME type instead of application/json? Why are you using nginx 1.2 which has more holes than a golf course?


We use our own mime type to support being asked for different version of a resource by the clients. By sending in an accept header with the correct mimetype, say "application/vnd.eve.ccp.Tournament-v1" the server knows to return you that particular version. It allows us to release new versions of these resource and your client will keep working as long as we support the version you want.


I presume this will be done via a Accept-Encoding header in the client's request?

Also, will you be sending proper cache control headers in the responses?
CCP QC
C C P
C C P Alliance
#16 - 2013-07-11 18:45:36 UTC
Tarsas Phage wrote:
CCP QC wrote:
Luigi Thirty wrote:
Why are you using your own MIME type instead of application/json? Why are you using nginx 1.2 which has more holes than a golf course?


We use our own mime type to support being asked for different version of a resource by the clients. By sending in an accept header with the correct mimetype, say "application/vnd.eve.ccp.Tournament-v1" the server knows to return you that particular version. It allows us to release new versions of these resource and your client will keep working as long as we support the version you want.


I presume this will be done via a Accept-Encoding header in the client's request?

Also, will you be sending proper cache control headers in the responses?


Done via the Accept header of the client request actually. We leave accept encoding alone so client can request compression if desired.

Yep.
Marcel Devereux
Aideron Robotics
Aideron Robotics.
#17 - 2013-07-11 18:53:42 UTC
I just want to respond again to tell you how floored I am about this. The tournaments API isn't something that we have been asking for, nor is it something that I am going to use right now, but it is still great! Giving the players access to live data is awesome! I can't wait to see more. Keep up the good work!
Theon Severasse
The Scope
Gallente Federation
#18 - 2013-07-12 10:07:39 UTC
For someone who doesn't have much experience working with this stuff (basically none Blink), is there an easy way of navigating through this stuff?

Specifically I was wanting to look at the results of the mock testing that happened the other week, but I honestly have no idea how to find it.
CCP FoxFour
C C P
C C P Alliance
#19 - 2013-07-12 10:31:55 UTC  |  Edited by: CCP FoxFour
Theon Severasse wrote:
For someone who doesn't have much experience working with this stuff (basically none Blink), is there an easy way of navigating through this stuff?

Specifically I was wanting to look at the results of the mock testing that happened the other week, but I honestly have no idea how to find it.


CCP QC wrote:
Some notes on this:
1) Halp, I clicked your link and my browser downloaded a weird file and I don't know what to do with it!!!
The CREST resources aren't webpages. Due to how we use mediatypes (See 9 below) you will in general need to use a browser plugin to see the data. I use Postman in Chrome ( https://chrome.google.com/webstore/detail/postman-rest-client/fdmmgilgnpjigdojojpjoooidkmcomcm ). Just head to whatever search engine you like and search for "MYBROWSER rest plugin" and you should be fine.


Install that extension for Chrome, or another one for your browser, open it, and give it the URL of: http://public-crest-duality.testeveonline.com/tournaments/

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.
Salpun
Global Telstar Federation Offices
Masters of Flying Objects
#20 - 2013-07-12 11:55:03 UTC
Just messing around with it. Finding the information you need to recreate what happened seems to be a daunting task. How close can some one get to re creating the broadcast UI in real time can some one get? The info to recreate the tournament broadcast UI data is all over the place.

Using the link you gave us in a reader just gives us a list of the data sets but does not give us the current key.

If i dont know something about EVE. I check https://wiki.eveonline.com/en/wiki/ISK_The_Guide

See you around the universe.
123Next pageLast page