esi / esi-docs Goto Github PK
View Code? Open in Web Editor NEWThe official repository for ESI documentation
License: MIT License
The official repository for ESI documentation
License: MIT License
I have tried to use EVE SDE Database Builder, but when I select all item to import,the program crashed. And how do I import Chinese data?
The Useful Formulae page should be updated to actually render the formulae.
One approach is to use a third-party service which renders them as images, such as @lukasni did in https://github.com/esi/esi-issues/blob/2c4462ed3aa68db8ab3c6d587756ee8eb4145f60/docs/useful_formulae.md.
Another is including a JS library which will render them, such as MathJax or KaTeX., You can find one of my attempts at this on https://carbonalabel.github.io/esi-docs/docs/useful_formulae.html and https://github.com/CarbonAlabel/esi-docs/blob/master/docs/useful_formulae.md.
If there's some third alternative, I'd love to hear about it.
The corresponding pages from the old docs can be used as a reference for what the rendered formulae are supposed to look like: https://eveonline-third-party-documentation.readthedocs.io/en/latest/formulas/
I would do it myself, but, it end up being CarbonAlabel who did all the work the last time...
I have a couple of smaller suggestions:
Add link the the swagger ui and the changelog to the “Important Online Resources” paragraph in the readme.
Also update description of #esi to include that the ccp devs are there and it’s a good place to check the health of esi and keep up with the community (I feel like getting people on #esi should be our number one priority).
I’m open to doing these changes myself (if the suggestions is accepted), but, fair warning: English is not my first language and I’m not exactly good with words.
Basically, the usage of <URL safe Base64(SHA256(URL safe Base64(random 32 byte string)))>
and <URL safe Base64(32 byte string) generated in step 3
> in the OAuth 2.0 for Mobile or Desktop Applications article is somewhat cumbersome and potentially misleading.
The python example is significantly clearer:
random
: random = base64.urlsafe_b64encode(secrets.token_bytes(32))
code_challenge
is created in several steps: m = hashlib.sha256()
m.update(random)
d = m.digest()
code_challenge = base64.urlsafe_b64encode(d).decode().replace("=", "")
My suggestion would be to define both the secret string and the challenge string once in the text and then use the synonyms for the code examples:
<URL safe Base64(32 byte string)>
<URL safe Base64(SHA256(random_string))>
Hope this helps! 🙂
If you follow https://docs.esi.evetech.net/changelog you will be greeted by a 404 page.
What is max length of ESI JWT token?
The SDE Introduction page is horribly out of date: it claims that the SDE still contains data in formats other than YAML, and contains links to a bunch of non-existent pages.
It could use being updated to better describe the current SDE, or at the very least pruned of the dead links.
I do have eTag support in ESI.NET added in if you want to update your third-party list.
Currently https://docs.esi.evetech.net/docs/sso/revoking_refresh_tokens.html states:
Note: it is currently a bug that basic authentication can only be used with the revocation endpoint. In the future, the EVE SSO will allow you use an access token instead for mobile/desktop applications.
Is there an ETA for this?
The final instruction in https://github.com/esi/esi-docs/blob/master/docs/sso/revoking_refresh_tokens.md says:
- If the revocation was successful you will get an HTTP response code of 200 back from the EVE SSO.
As described in https://tools.ietf.org/html/rfc7009#section-2.2, a 200 response code from the revocation endpoint is not confirmation that the token was revoked, and will be returned even if an invalid token was sent to the endpoint.
The docs should be updated to make this clearer.
The SSO docs for using the revocation endpoint (https://github.com/esi/esi-docs/blob/master/docs/sso/revoking_refresh_tokens.md) still suggest the use of JSON request bodies. This is not according to spec, and is unsupported behavior.
The docs page and the associated code example should be updated to use form encoded request bodies, similar to how it was done in 290bb2a.
I use this link to authorize.
https://login.eveonline.com/oauth/token
Many characters have been authorized, and is there any way to convert them directly to the authorization generated by such links?
https://login.eveonline.com/v2/oauth/token
Or in future plans, all characters will be reauthorized again?
I was reading through the docs to learn about the API and I found something odd. These id ranges don't make sense.
Consider this truncated version of the table:
From | To | Description |
---|---|---|
0 | 10,000 | System items (including junkyards and other special purpose items) |
~ | ~ | ~ |
50,000,000 | 60,000,000 | Stargates |
60,000,000 | 61,000,000 | Stations created by CCP |
~ | ~ | ~ |
2,100,000,000 | 2,147,483,647 | DUST characters, EVE characters created after 2016-05-30 |
To ensure we all understand each other I'm defining ranges as such:
'1 to 5 exclusive' means '1, 2, 3, 4'
'1 to 5 inclusive' means '1, 2, 3, 4, 5'
With that table it isn't clear if the ranges are inclusive or exclusive. An ID of 60,000,000 could be a stargate or a station. Typically in these kinds of situation I assume the intent is exclusive ranges since that is the default behaviour in a lot of coding languages. With that assumption 60,000,000 would be a station and not a stargate.
However the last entry seems to contradict that assumption.
2,100,000,000 to 2,147,483,647
2,147,483,647 is the max value you can store in a 32-bit signed integer.
Therefore I assume this is meant to be understood as "the rest of the integer is used for these IDs".
However if we continue with the exclusive range assumption as before that would be it actually means "the rest of the integer, except the last value".
That seems like an odd range to choose. I assume it is incorrect (seems odd to reserve just the last value). Ideally the page would get updated with the correct ranges and it wouldn't hurt to explicitly state on the page if the range is inclusive or exclusive.
As a bonus it be nice to specify the max integer size required to store the value but most people likely don't care about that.
the script editor is giving an error of "Missing ) after formal parameters. (line 11, file "location")"
on each script i use
please pardon my noobness i did google the problem but couldn't figure it out
The closest thing we have to an official list of ID ranges is currently the following gist: https://gist.github.com/a-tal/5ff5199fdbeb745b77cb633b7f4400bb
As it is owned by an ex-CCP developer who has been inactive for a while, it would be better and far more maintainable to have the list included in these docs.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.