Version 2 XML interface.
Posted: 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, 30000 calls per day for each platinum account and 6000 calls per day for each gold account. Also for each hour you are limited to 2500 calls for each platinum account and 500 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.
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, 30000 calls per day for each platinum account and 6000 calls per day for each gold account. Also for each hour you are limited to 2500 calls for each platinum account and 500 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.