Website & Forums Fix The Api And The Docs

This thread outlines my observations to the API and the docs and suggests possible fix.

1. Update the API endpoints in the docs.
It appears that the server is still undergoing some major migration so 1/3 of the API is available at api.wynncraft.com, another 1/3 of the API is available at api-legacy.wynncraft.com and the final 1/3 is just broken. Please, if you're serving from api-legacy, update the docs to reflect that, we will gladly update our code instead of having to scratch our heads wonder why no wars are logged.

2. Serve latest data from the API.
It seems to me that certain endpoints are serving old data, possibly from the old servers. Just move those scripts over and start giving us the latest data perhaps? My last seen is within an hour, not some 18 days.

3. Return correct guild info for players.
While trying to retrieve the stats for some players, they appear to be guildless, yet by searching their guild, they are in the member list. A similar problem also exists in the guild chat, where for players that have changed their usernames after joining the guild, their rank can't be displayed. This may be due to the wrong conditions being used in the SQL queries to retrieve player data, and the fix is to filter by uuid instead of IGN. The same goes if you use the join clause instead of the where clause.

4. Use standardised date formats in the API.
Dates such as "2020-05-24 14:40:42" looks fancy, they are human readable, but not developer friendly, as we have to guess the timezone. Either use unix timestamps like 1590331242 or a standard machine readable format such as "2020-05-24T14:40:42Z". Most programming languages provide APIs to convert dates.

5. Actually deprecate APIs instead of removing the old version all of a sudden.
Most services that provides an API update their API from time to time, on each update, they usually increment the API version, deprecate the old version by announcing that it will be unavailable after a set time period like 3 months, then execute the schedule. That gives developers time to smoothly transition to your more recent version of the API yet keeping the community's creations from breaking. I haven't seen an API provider to absurdly stop access to an API version apart from Wynn.

6. Optional, but make certain /guild commands available while in war.
/gu contribute in wars causes duping apparently, but /gu stats doesn't hurt, neither do /gu list.

7. Also optional, but add an official forums link shortener.

 

Please add a poll.

I honestly don't think that solving the API problem is as simple as that, but then again, I could be completely wrong, you probably know more about that kind of stuff than I do, because I am clueless when it comes to computers and stuff like that.

 

The title is misleading and makes your suggestion look much worse (simple and like the much-spammed "fix the api already) than it deserves to be, something like "Please standardize the API and Docs and make them dev-friendly" might be better!


okay my suggested title sucks
+1

 

This, definitely. I thought this was gonna be another zero effort zero research fix lag type thread. I do agree with most of these, though the last two could be a separate suggestion or something as they're pretty not related.