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 page
 

CREST changes coming to Sisi

First post
Author
CCP FoxFour
C C P
C C P Alliance
#1 - 2016-01-04 14:14:59 UTC
Hey people,

Wanted to give you all a heads up about some changes coming to Sisi later today. Hopefully they will be deployed around 15:00. Here is a brief rundown of the changes:

Alliance resources:
- Version 1 of the Alliances resource is now deprecated.
- Version 2 has been added to fix the awkward formatting of having a href in a href nonsense. Sorry about that.
- V2 has a 5 minute cache.
- Fixed a defect in the Alliance resource where if the executor corp no longer existed the resource would fail to be parsed. Fixing this means the executorCorporation field is now optional.

Universe resources:
- Added ID for the regions collection and individual region resources.
- Added a constellations collection.
- Added ID to the individual constellation resource.
- Added a solar systems collection.
- Added the new constellations and solar system collections as a link in the root of CREST.

Contacts:
- Fixed a defect where if a contact list contained an alliance the resource would fail to parse.
- Finalized work on exposing read and write access for contacts to third-party developers.

Dogma information:
- Added two new collections for dogma effects and dogma attributes to CREST.
- Added information about a types dogma attributes and dogma effects to the type resource.
- Added a link to dogma effects and dogma attributes from the root.

Added character waypoints to CREST:
- This gives developers the ability to send a POST request to the waypoints resource, linked from the character resource, and set a client's auto pilot destination. This will turn off the autopilot on the client.

Other:
- Exposing a characters location with the charactersLocationRead scope and a cache time of 10 seconds. !! THIS CACHE TIME IS SUBJECT TO CHANGE !!
- Added ID attribute for types in market types.
- Added ID attribute for market groups in market groups.
- Added typeID to the type collection and type resource.





This is the current version on Sisi: EVE-2016-ALEX 14.1.993568.993561

You can see the version in the CREST root. When the last two numbers are both equal to or above 994194 it will have been updated to include all my stuff.

Some extra scopes are going to be required for some of these resources to work, namely charactersLocationRead and charactersNavicationWrite. I will post back once I have those on Sisi. I think the contacts write one is already there.

Here is an example of setting a waypoint:
{
    "solarSystem": {"href": "http://crest.regner.dev/solarsystems/30000142/", "id": 30000142},
    "first": true,
    "clearOtherWaypoints": false
}


It only works for solar systems at this time. I will try and add stations for the next release next month.

Anyways, gotta run. Will try and respond with more details later.

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

Querns
GoonWaffe
Goonswarm Federation
#2 - 2016-01-04 14:21:48 UTC
Very cool stuff! I was wondering what had happened to dogma attributes in CREST, as it had been talked about some time ago.

I'm also very happy to see replacements for in-game-browser functionality being realized. We knew this was part of your goal, but seeing character location implemented is still very good to see.

Thanks, as always, for your work in this area of the game's code! The API and CREST are integral parts of the game's experience.

This post was crafted by the wormhole expert of the Goonswarm Economic Warfare Cabal, the foremost authority on Eve: Online economics and gameplay.

CCP FoxFour
C C P
C C P Alliance
#3 - 2016-01-04 14:24:33 UTC  |  Edited by: CCP FoxFour
As an advisory this is going to be one of the first cases where we really bump a version number and break backwards. Specifically this is in the Alliance resource. If you use that and do not send an Accept header you are going to get the newest version and your **** is probably going to break. You have been warned.

https://eveonline-third-party-documentation.readthedocs.org/en/latest/crest/versioning/

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

CCP Tellus
C C P
C C P Alliance
#4 - 2016-01-04 14:30:55 UTC
You are awesome, FoxFour! Blink
CCP FoxFour
C C P
C C P Alliance
#5 - 2016-01-04 14:49:28 UTC
I have added the following scopes to Sisi: characterContactsWrite, characterNavigationWrite, and characterLocationRead

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

Rudy Miller
Doomheim
#6 - 2016-01-04 14:51:31 UTC
CCP FoxFour wrote:

- Exposing a characters location with the charactersLocationRead scope and a cache time of 10 seconds. !! THIS CACHE TIME IS SUBJECT TO CHANGE !!


What kind of data does charactersLocationRead provide? System? XYZ coords? Something else?
CCP FoxFour
C C P
C C P Alliance
#7 - 2016-01-04 14:53:49 UTC
Rudy Miller wrote:
CCP FoxFour wrote:

- Exposing a characters location with the charactersLocationRead scope and a cache time of 10 seconds. !! THIS CACHE TIME IS SUBJECT TO CHANGE !!


What kind of data does charactersLocationRead provide? System? XYZ coords? Something else?


Just solar system. Here is a sample output:

{
  "solarSystem": {
    "id_str": "30000140",
    "href": "http://crest.regner.dev/solarsystems/30000140/",
    "id": 30000140,
    "name": "Maurasi"
  }
}


It will return an empty dictionary of the character is offline.

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

CCP FoxFour
C C P
C C P Alliance
#8 - 2016-01-04 15:14:47 UTC
The new waypoints resource and the location resource can both be found via links in the character resource.

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

CCP FoxFour
C C P
C C P Alliance
#9 - 2016-01-04 15:15:48 UTC
Oh also, because I have been a bit busy I haven't exposed the new dogma resources in public CREST on Sisi. You should however have no problem getting them from authenticated CREST. Both linked from the CREST root.

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

CCP FoxFour
C C P
C C P Alliance
#10 - 2016-01-04 15:27:33 UTC
Server is up with the changes.

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

Ortho Loess
The Legion of Spoon
Curatores Veritatis Alliance
#11 - 2016-01-04 16:45:34 UTC
Rudy Miller wrote:
What kind of data does charactersLocationRead provide? System? XYZ coords? Something else?


See Fox. It's not just me who thinks xyz might be cool! P
Zifrian
The Pannion Domin
Ghostbirds
#12 - 2016-01-04 17:02:15 UTC
Wow, nice stuff in there. Thanks for all the support on CREST FF.

Maximze your Industry Potential! - Download EVE Isk per Hour!

Import CCP's SDE - EVE SDE Database Builder

Louis Vitton
Viziam
Amarr Empire
#13 - 2016-01-04 17:36:18 UTC
Thanks Fox for addressing this one;
- Fixed a defect in the Alliance resource where if the executor corp no longer existed the resource would fail to be parsed. Fixing this means the executorCorporation field is now optional.

I will test later with some that used to give the 500 error.
Risingson
#14 - 2016-01-04 19:24:48 UTC
CCP FoxFour wrote:
- Exposing a characters location with the charactersLocationRead scope and a cache time of 10 seconds. !! THIS CACHE TIME IS SUBJECT TO CHANGE !!


is the cache time likely to get shorter (4 sec) or longer ?
thank you for your work.
CCP Tellus
C C P
C C P Alliance
#15 - 2016-01-04 19:35:20 UTC
Risingson wrote:
is the cache time likely to get shorter (4 sec) or longer ?

Depends on how much people yell at us. Smile
CCP FoxFour
C C P
C C P Alliance
#16 - 2016-01-04 19:35:58 UTC
Risingson wrote:
CCP FoxFour wrote:
- Exposing a characters location with the charactersLocationRead scope and a cache time of 10 seconds. !! THIS CACHE TIME IS SUBJECT TO CHANGE !!


is the cache time likely to get shorter (4 sec) or longer ?
thank you for your work.


It is more likely to go up but I am hoping after some optimizations made today we can actually go lower. Just need to see what this does to load on TQ. TQ behaves so differently than anything else. :(

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

Max Kolonko
Caldari Provisions
Caldari State
#17 - 2016-01-04 20:08:39 UTC  |  Edited by: Max Kolonko
CCP Tellus wrote:
Risingson wrote:
is the cache time likely to get shorter (4 sec) or longer ?

Depends on how much people yell at us. Smile


find two closest stargates in one system, take very fast align/warp ship (taxi ceptor for example) and see how fast he can get from system load in that system to system change while jumping to next one. This should be absolute maximum this timer should be imho.

EDIT: tested for 25k km warp to gate. 11~12 seconds, so please dont make it bigger than 10 seconds. (tested in 1.7 s align time, 12.17 AU/s warp speed ceptor, without taking system loading into consideration but at the same time only to gate flash and not system name change, but those two "should" be comparable)

The idea is, that once You jump into the system there have to be enough time for cache to clear to catch that You are in new system before jumping to next one. I want to plot LIVE movement of my entire corp on map :)
Max Kolonko
Caldari Provisions
Caldari State
#18 - 2016-01-04 20:32:38 UTC
Btw, what kind of rate limit Are You guys planning for it? Can I for example have 100 persons loggged in into my app and check their locations every 10 seconds? Or 300? Or 1000?
Risingson
#19 - 2016-01-04 20:35:16 UTC
CCP FoxFour wrote:
It is more likely to go up but I am hoping after some optimizations made today we can actually go lower. Just need to see what this does to load on TQ. TQ behaves so differently than anything else. :(


when i thought about those upcoming changes i thought of why not have the eve client tell stuff via a localhost?
that would mean instant info and no TQ load at all?
i am a dummy at such things so i don't know about the technical sides of that brainstorm though.
CCP FoxFour
C C P
C C P Alliance
#20 - 2016-01-04 20:36:35 UTC
Max Kolonko wrote:
Btw, what kind of rate limit Are You guys planning for it? Can I for example have 100 persons loggged in into my app and check their locations every 10 seconds? Or 300? Or 1000?


Should be fine. We will toss 503's if you start doing to many requests and we can evaluate the rate limit at that time.

@CCP_FoxFour // Technical Designer // Team Tech Co

Third-party developer? Check out the official developers site for dev blogs, resources, and more.

123Next page