Version 2 XML interface.

Information about the VA integration pack
Post Reply
User avatar
joefremont
FSAirlines Developer
Posts: 3015
Joined: Tue May 16, 2006 5:46 am
Location: KSFO

Version 2 XML interface.

Post by joefremont » Sat May 29, 2021 7:21 pm

Hi Flyers. Today I am releasing as beta version 2 of the XML interface. The big changes in this version are:

The official documentation is here:
https://wiki.fsairlines.net/index.php/XML-Interface-v2

Change from domain registration to API keys.
- This is self service, you don't have to wait for an admin to give it. You can access this from the page where you update your VA settings.

Rate limits added.
- The limits are based on how many premium accounts your VA has, 6000 calls per day for each platinum account and 1200 calls per day for each gold account. Also for each hour you are limited to 500 calls for each platinum account and 100 calls for each gold account.

Json output format added.
- There are some who have said XML is obsolete, so a JSON format option is now added.

Output properly supports UTF-8 character set.
- Version 1 did not encode property for UTF-8 but I did not want to change anything as those who are reading expect it to be the way it is, but in version 2 its been fixed to handle it correctly.

Additional functions for packages added.
- Your not going to be able to read the list of packages from every airport or load packages onto aircraft using these functions but you will be able get airport summaries (within your rate limits) and see packages loaded on your aircraft and airport centers. Documentation of these is still pending.

The rate limits are needed as there a few airlines that are really over using the current interface, at least one VA is making over 90,000 calls per day. But over 90% of all VA's using the current interface would not be impacted by this limit. For now the V1 interface is not limited, but when the beta period for v2 is done I will be putting the limits on that as well.

Assuming everything goes as planned I will be turning off the v1 interface at the end of 2021.
Image
I've sworn an oath of solitude until the pestilence is purged from the lands.

brazvo
Ticket Agent
Posts: 13
Joined: Thu Mar 11, 2021 5:40 pm

Re: Version 2 XML interface.

Post by brazvo » Mon May 31, 2021 3:26 pm

Oh, such a great new! Thanks really much Joe.

Bruno
Image

nichtDanger
Ticket Agent
Posts: 2
Joined: Sun May 09, 2021 2:36 am

Re: Version 2 XML interface.

Post by nichtDanger » Tue Jun 01, 2021 12:46 pm

This is awesome! Thanks a lot!
Image

User avatar
joefremont
FSAirlines Developer
Posts: 3015
Joined: Tue May 16, 2006 5:46 am
Location: KSFO

Re: Version 2 XML interface.

Post by joefremont » Mon Jun 07, 2021 10:56 pm

I just did an update to the interface code.

the bookFlight function now works.

There was a bug where when using json format some of keys in the data objects were in a mixed upper/lower case. They should always be in lower case, except whey they represent an airport code.

This is now deployed.
Image
I've sworn an oath of solitude until the pestilence is purged from the lands.

Post Reply