API Maintenance 2/13

API Maintenance 2/13

in API Development

Posted by: Pat Cavit.9234

Pat Cavit.9234

Web Programming Lead

Next

We’re going to be doing some behind-the-scenes maintenance in a few minutes, in theory there should be few/no user facing changes but you never know. Tests are looking good.

We’ll be switching the API frontends over to a brand-new version that is easier to maintain for us. This work also sets up the last bit of groundwork required to ship authenticated APIs, which we’re hoping to do next week.

It’s not ready, but we’re working on a post with more details about our near & mid-term hopes and dreams for the API. We’ll be looking for feedback on the authenticated APIs as well as trying to give some sense of what we’re planning to ship going forward. The intent is to model it along the lines of the CDI threads you see for game design.

API Maintenance 2/13

in API Development

Posted by: Pat Cavit.9234

Previous

Pat Cavit.9234

Web Programming Lead

Next

The switchover has completed. We’re not quite done with the maintenance, next we’ll be changing the DNS record for api.guildwars2.com to use latency-based routing to send folks to either the US or EU. Previously all API traffic was served from our US datacenter.

We’ve also enabled most of the rest of the /v2 APIs that were still disabled, though a few are still hanging out pending a more complete review.

The newly-enabled /v2 APIs are:

  • /v2/build
  • /v2/colors
  • /v2/continents
  • /v2/files
  • /v2/floors
  • /v2/maps
  • /v2/skins

API Maintenance 2/13

in API Development

Posted by: smiley.1438

smiley.1438

Thanks Pat!

I wish the floors API would have been changed to be more useful. Seems like we still need to loop through the whole thing to find a single POI.

Also:
https://forum-en.gw2archive.eu/forum/community/api/API-Suggestion-Maps-API/first#post2261295
https://forum-en.gw2archive.eu/forum/community/api/It-has-become-silent-in-here/2501399

API Maintenance 2/13

in API Development

Posted by: Pat Cavit.9234

Previous

Pat Cavit.9234

Web Programming Lead

Next

Thanks Pat!

I wish the floors API would have been changed to be more useful. Seems like we still need to loop through the whole thing to find a single POI.

Also:
https://forum-en.gw2archive.eu/forum/community/api/API-Suggestion-Maps-API/first#post2261295
https://forum-en.gw2archive.eu/forum/community/api/It-has-become-silent-in-here/2501399

The floors API hasn’t gotten much love, as you can see. I’m open to changing the format because it’s straightforward for us to do. So far we’ve been focused on porting the previous API code onto the new backend and prepping for authenticated APIs.

What we should change the format to will be something we should discuss as part of the upcoming API discussion thread. We can use the posts you linked as a starting point for that discussion.

API Maintenance 2/13

in API Development

Posted by: Aerodin.2795

Aerodin.2795

We’ll be switching the API frontends over to a brand-new version that is easier to maintain for us. This work also sets up the last bit of groundwork required to ship authenticated APIs, which we’re hoping to do next week.

Wow this is pretty huge news, and really exciting!! Just so it’s clear, is the plan/hope to have a thread to talk about future plans next week, or for the actual authenticated APIs to be available next week?

Author of GW2 PAO

API Maintenance 2/13

in API Development

Posted by: Pat Cavit.9234

Previous

Pat Cavit.9234

Web Programming Lead

Next

We’ll be switching the API frontends over to a brand-new version that is easier to maintain for us. This work also sets up the last bit of groundwork required to ship authenticated APIs, which we’re hoping to do next week.

Wow this is pretty huge news, and really exciting!! Just so it’s clear, is the plan/hope to have a thread to talk about future plans next week, or for the actual authenticated APIs to be available next week?

Both. The switchover in code happened this morning. Next week we’ll definitely kick off the CDI thread.

Not going to 100% promise that we will be able to enable the authenticated APIs then but it’s what we’re shooting for.

In the “managing expectations” department: The first authenticated API will be very simple. We’re starting with something simple and with low technical risk in case everything lights itself on fire.

API Maintenance 2/13

in API Development

Posted by: Aerodin.2795

Aerodin.2795

We’ll be switching the API frontends over to a brand-new version that is easier to maintain for us. This work also sets up the last bit of groundwork required to ship authenticated APIs, which we’re hoping to do next week.

Wow this is pretty huge news, and really exciting!! Just so it’s clear, is the plan/hope to have a thread to talk about future plans next week, or for the actual authenticated APIs to be available next week?

Both. The switchover in code happened this morning. Next week we’ll definitely kick off the CDI thread.

Not going to 100% promise that we will be able to enable the authenticated APIs then but it’s what we’re shooting for.

In the “managing expectations” department: The first authenticated API will be very simple. We’re starting with something simple and with low technical risk in case everything lights itself on fire.

Makes sense. Looking forward to it!

Author of GW2 PAO

API Maintenance 2/13

in API Development

Posted by: Keider.8652

Keider.8652

We’ll be switching the API frontends over to a brand-new version that is easier to maintain for us. This work also sets up the last bit of groundwork required to ship authenticated APIs, which we’re hoping to do next week.

Wow this is pretty huge news, and really exciting!! Just so it’s clear, is the plan/hope to have a thread to talk about future plans next week, or for the actual authenticated APIs to be available next week?

Both. The switchover in code happened this morning. Next week we’ll definitely kick off the CDI thread.

Not going to 100% promise that we will be able to enable the authenticated APIs then but it’s what we’re shooting for.

In the “managing expectations” department: The first authenticated API will be very simple. We’re starting with something simple and with low technical risk in case everything lights itself on fire.

Very nice to get the old endpoints standardized, and so quickly! I’m looking forward to that CDI thread
I’ll have to agree with smiley.1438 though, the floor endpoint has room for improvement.

Durmand Scriptorium - PHP wrapper for the API

(edited by Keider.8652)

API Maintenance 2/13

in API Development

Posted by: aRestless.6213

aRestless.6213

Quick question: Does the floor-API allow to (indirectly) convert from character position to floor?

Cause that’s something I could use for Markers. A lot.

Never lose track of your friends again, with Who’s Talking for Overwolf

API Maintenance 2/13

in API Development

Posted by: Pat Cavit.9234

Previous

Pat Cavit.9234

Web Programming Lead

After some deep thoughts and a quick huddle over here we’re disabling /v2/floors, we’re not happy with how it looks and want to revisit it before anyone writes code to depend on it.

API Maintenance 2/13

in API Development

Posted by: smiley.1438

smiley.1438

After some deep thoughts and a quick huddle over here we’re disabling /v2/floors, we’re not happy with how it looks and want to revisit it before anyone writes code to depend on it.

What can i say? Yay, go for it! Help us to create shiny maps, especially on the Wikis! Everyone wants them but the floors API isn’t handy at all.

API Maintenance 2/13

in API Development

Posted by: Chokapik.3741

Chokapik.3741

Oh, that’s so cool!
Although, have you considered adding the dye item ID in the /v2/colors API? It would be really nice because right now, we have no way to make the conversion from a color to an actual in-game dye.
Edit: Actually we have the dye name, but I think it would be more useful to get the ID.

Escape from Rata Sum: http://orikaru.net/ratascape
Guild Emblem Editor: http://nailek.net/gw2/emblemeditor

(edited by Chokapik.3741)

API Maintenance 2/13

in API Development

Posted by: smiley.1438

smiley.1438

Well, having the item database makes this a simple task. Speaking of the colors API:
https://forum-en.gw2archive.eu/forum/community/api/API-Suggestion-Colors-API/2910450

(dang, why has the master sticky thread been unstickied?)

API Maintenance 2/13

in API Development

Posted by: darthmaim.6017

darthmaim.6017

Those are awesome news!

API Maintenance 2/13

in API Development

Posted by: Dr Ishmael.9685

Dr Ishmael.9685

Chokapik: What smiley was referring to is the color_id attribute of the consumables detail object on the /v2/items endpoint. If you have an item database available, you can join your consumables to your colors on that field.

API Maintenance 2/13

in API Development

Posted by: Chokapik.3741

Chokapik.3741

Yes, that would work, but I don’t think iterating through ALL the items when you just want to get the dyes is very efficient.
If you simply want to do something where the user can check all the colors, choose one they like before buying it in-game, at some point you’re going to need a way to make the conversion between a color and a dye (consumable).

Escape from Rata Sum: http://orikaru.net/ratascape
Guild Emblem Editor: http://nailek.net/gw2/emblemeditor

API Maintenance 2/13

in API Development

Posted by: AysonCurrax.3254

AysonCurrax.3254

I noticed some odd behaviour with the v1/skin_details.json end point. It seems to have some encoding issues, but i am not sure if that is related to the maintenance or not, so i am posting it here just incase.
namely, the “Einhänder” and “Zweihänder” got their names all messed up in the v1 endpoint as can be seen here:
https://api.guildwars2.com/v1/skin_details.json?skin_id=5231
https://api.guildwars2.com/v1/skin_details.json?skin_id=5193

the same thing doesnt seem to happen in the new v2 api though :
https://api.guildwars2.com/v2/skins/5231
https://api.guildwars2.com/v2/skins/5193

API Maintenance 2/13

in API Development

Posted by: smiley.1438

smiley.1438

I noticed some odd behaviour with the v1/skin_details.json end point. It seems to have some encoding issues, but i am not sure if that is related to the maintenance or not, so i am posting it here just incase.
namely, the “Einhänder” and “Zweihänder” got their names all messed up in the v1 endpoint as can be seen here:
https://api.guildwars2.com/v1/skin_details.json?skin_id=5231
https://api.guildwars2.com/v1/skin_details.json?skin_id=5193

the same thing doesnt seem to happen in the new v2 api though :
https://api.guildwars2.com/v2/skins/5231
https://api.guildwars2.com/v2/skins/5193

See: https://forum-en.gw2archive.eu/forum/community/api/Guild-API-strings-are-UTF-8-encoded-twice

API Maintenance 2/13

in API Development

Posted by: AysonCurrax.3254

AysonCurrax.3254

I noticed some odd behaviour with the v1/skin_details.json end point. It seems to have some encoding issues, but i am not sure if that is related to the maintenance or not, so i am posting it here just incase.
namely, the “Einhänder” and “Zweihänder” got their names all messed up in the v1 endpoint as can be seen here:
https://api.guildwars2.com/v1/skin_details.json?skin_id=5231
https://api.guildwars2.com/v1/skin_details.json?skin_id=5193

the same thing doesnt seem to happen in the new v2 api though :
https://api.guildwars2.com/v2/skins/5231
https://api.guildwars2.com/v2/skins/5193

See: https://forum-en.gw2archive.eu/forum/community/api/Guild-API-strings-are-UTF-8-encoded-twice

ahh, thank you. well, instead of meddling with a workaround for now, ill just leave it as is and wait for it to be fixed. Just figured it might be related to the maintenance, since an older database of mine didnt seem to have that weird issue. it being here might raise some attention, though, so it probably isnt that bad to be where it might not belong :x