Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

User:Rayanth/Sandbox2: Difference between revisions

From EVE University Wiki
Rayanth (talk | contribs)
m Comment out {{Stub}}, should not be used in the User namespace.
 
(7 intermediate revisions by 2 users not shown)
Line 2: Line 2:
===For Non-Developers===
===For Non-Developers===
Safety: Your SSO username and password are completely safe from the third party application you're logging in to. When logging in to another service with SSO, you are actually logging on to the SSO server via a website hosted by CCP themselves. This setup is the core of an authentication method called OAuth (and its newer version, OAuth2). OAuth/OAuth2 are very widely used today, and act as the core component for logs on most social media giants, including Facebook, Twitter, and Google, including any other site that allows you to use those Social Media accounts to log in to them.  
Safety: Your SSO username and password are completely safe from the third party application you're logging in to. When logging in to another service with SSO, you are actually logging on to the SSO server via a website hosted by CCP themselves. This setup is the core of an authentication method called OAuth (and its newer version, OAuth2). OAuth/OAuth2 are very widely used today, and act as the core component for logs on most social media giants, including Facebook, Twitter, and Google, including any other site that allows you to use those Social Media accounts to log in to them.  
Here is a brief tour of the process, for a new 3rd party Eve Online tool, 3rd Party Website (3PW for short):
Here is a brief tour of the process, for a new 3rd party EVE Online tool, 3rd Party Website (3PW for short):


* 3PW registers its existence on CCP's servers. It defines a Redirect URL that will be listening for SSO to talk to it when a user logs in.
* 3PW registers its existence on CCP's servers. It defines a Redirect URL that will be listening for SSO to talk to it when a user logs in.
Line 34: Line 34:
=BreakBreak=
=BreakBreak=
=Existing Page=
=Existing Page=
{{stub}}
<!--{{stub}}-->
EVE Swagger Interface (ESI) is an API to get data from the EVE server. It replaces [[CREST]] and the XML API which were shut down on May 8th, 2018.<ref>https://developers.eveonline.com/blog/article/important-information-on-the-future-of-the-eve-api</ref>
EVE Swagger Interface (ESI) is an API to get data from the EVE server. It replaces CREST and the XML API which were shut down on May 8th, 2018.<ref>https://developers.eveonline.com/blog/article/important-information-on-the-future-of-the-eve-api</ref>


Remember that scamming with API is specifically not allowed<ref name="scamming">[https://developers.eveonline.com/blog/article/reminder-no-scamming Reminder to Developers: No Scamming]</ref>
Remember that scamming with API is specifically not allowed<ref name="scamming">[https://developers.eveonline.com/blog/article/reminder-no-scamming Reminder to Developers: No Scamming]</ref>
Line 67: Line 67:
=BreakBreakBreak=
=BreakBreakBreak=
=NewPage=
=NewPage=
EVE Swagger Interface (ESI) is an API that can be used by [[Third-party_tools|third party applications]] to interact with data from the EVE game servers. It replaces [[CREST]] and the XML API which were shut down on May 8th, 2018.<ref>https://developers.eveonline.com/blog/article/important-information-on-the-future-of-the-eve-api</ref>
EVE Swagger Interface (ESI) is an API that can be used by [[Third-party_tools|third party applications]] to interact with data from the EVE game servers. It replaces CREST and the XML API which were shut down on May 8th, 2018.<ref>https://developers.eveonline.com/blog/article/important-information-on-the-future-of-the-eve-api</ref>


ESI has both public-data and authenticated endpoints, the latter of which require a character to log in via [[Eve SSO]] to their character account to gain access to information specific to their character or, provided they have the appropriate corporate roles, their corporation. At present there are 81 public-data and 125 Authenticated endpoints (206 total).
ESI has both public-data and authenticated endpoints, the latter of which require a character to log in via [[EVE SSO]] to their character account to gain access to information specific to their character or, provided they have the appropriate corporate roles, their corporation. At present there are 81 public-data and 125 Authenticated endpoints (206 total).


CCP has indicated that their goal is to completely replace the [[Static Data Export|Static Data Export]] (SDE) with ESI, but as of December 2019, there are still many missing features.
CCP has indicated that their goal is to completely replace the [[Static Data Export|Static Data Export]] (SDE) with ESI, but as of December 2019, there are still many missing features.
Line 75: Line 75:
As a reminder to developers, it is expressly forbidden for developers of third party applications to use them for ill intent<ref name="scamming">[https://developers.eveonline.com/blog/article/reminder-no-scamming Reminder to Developers: No Scamming]</ref><ref>https://developers.eveonline.com/resource/license-agreement</ref>
As a reminder to developers, it is expressly forbidden for developers of third party applications to use them for ill intent<ref name="scamming">[https://developers.eveonline.com/blog/article/reminder-no-scamming Reminder to Developers: No Scamming]</ref><ref>https://developers.eveonline.com/resource/license-agreement</ref>


ESI and SSO are commonly used together, however they do have independent features and uses as well. For this reason, they have been split into their own articles. See [[SSO]] for information regarding the character authentication (and management thereof) aspect.
ESI and SSO are commonly used together, however they do have independent features and uses as well. For this reason, they have been split into their own articles. See [[EVE SSO]] for information regarding the character authentication (and management thereof) aspect.


==ESI Endpoints==
==ESI Endpoints==
Line 82: Line 82:
The general categories these endpoints fall under are:
The general categories these endpoints fall under are:
{| class="wikitable sortable"
{| class="wikitable sortable"
! Category !! Public !! Authenticated !! Description
! Category !! Public !! Auth !! Description
|-
|-
| Alliances || 4 || || General information about Alliances and their member corporations
| Alliances || 4 || || General information about Alliances and their member corporations
Line 148: Line 148:
| Wars || 3 || || Details on all wars that have happened in the game, including their killmails.
| Wars || 3 || || Details on all wars that have happened in the game, including their killmails.
|}
|}
== Resources For Developers ==
There are a number of resources online for developers looking to begin using ESI, many of which also cover SSO for authenticating endpoints.
{| class="wikitable"
|-
| https://docs.esi.evetech.net/ || Community-maintained documentation for ESI.
|-
| https://eveonline-third-party-documentation.readthedocs.io/en/latest/esi/index.html || CCP's documentation on ESI. (Outdated)
|-
| https://github.com/esi/esi-issues || Official Git Repository for tracking issues and requests for ESI.
|-
| https://github.com/esi/esi-issues/issues/1103 || A specific issue on the above repository, that compares ESI to the information available in SDE.
|-
| https://community.eveonline.com/news/dev-blogs/introducing-esi/ || Original Announcement introducing ESI.
|-
| https://esi.evetech.net/ui/ || CCP's front-end User Interface for "playing" with ESI and discovering what the various endpoints can do.
|-
| https://github.com/devfleet/awesome-eve#developer-tools-resources-and-apis || Community-maintained list of resources and tools to work with ESI.
|-
| https://forums.eveonline.com/t/3-3-0-gesi-google-sheets-esi-library/13406 || GESI - A library for working with ESI in Google Sheets
|-
| https://developers.eveonline.com/blog/article/using-esi-with-google-sheets || A slightly outdated CCP Dev blog on working with GESI (see above)
|-
| https://www.fuzzwork.co.uk/2017/03/14/using-esi-google-sheets/ || A different guide on working with GESI (see above)
|-
| https://wiki.zansha.space/index.php/SSO_Authentication_in_Microsoft_Power_Query || Information on working with ESI in MS Excel with Power Query
|}
== References ==
<references />
<!--[[Category:API]]-->