Version lifetime
We now have a system in place to remove old versions of specific API's.
We have chosen to do this, because we want our API's to be as safe as possible. The older an API becomes the older the code/services become and that can prove to introduce different bugs/issues.
These things are hard to recognize and can sometimes stay under the radar for multiple years, to avoid this we have chosen to give each API version a lifetime.
An Active Release will stay in this phase for 2 months. After that it will turn into a Stable Release, it will stay in this phase for 12 months after the next release. While there is no other release, the end date for this version will say "TBD" (To Be Determined).
To make it easy for developers we made sure you can still call a version that has been removed, by using the old version's URL. Once you call a version that has been removed, your call will be forwarded to the oldest version that is currently live. This rule also applies when you call a version that does not exists like "v99.1".
Let's say v1.0 has been removed and v1.1 is still live, every call to v1.0 will be handled as if it was a call to v1.1.
With every request we add a response header called X-Parley-API-Version which tells you what version actually handled
your request. The value for v1.1 is 10100 which translates to 1.01.00 major.minor.patch.
Releases
Client API
| Version | Active release date | Stable release date | Unsupported date |
|---|---|---|---|
| 1.9 | 24-04-2025 | TBD | TBD |
| 1.8 | 19-12-2022 | 24-04-2025 | 24-04-2026 |
| 1.7 | 22-10-2021 | 19-12-2022 | 19-12-2023 |
| 1.6 | 11-03-2021 | 22-10-2021 | 22-10-2022 |
| 27-01-2021 | 11-03-2021 | 11-03-2022 | |
| 10-11-2020 | 27-01-2021 | 27-01-2022 |
Service API
| Version | Active release date | Stable release date | Unsupported date |
|---|---|---|---|
| 2.5 | 17-04-2025 | TBD | TBD |
| 2.4 | 19-12-2022 | 17-04-2025 | 17-04-2026 |
| 02-09-2022 | 19-12-2022 | 19-12-2023 | |
| 22-10-2021 | 02-09-2022 | 02-09-2023 |
Admin API
| Version | Active release date | Stable release date | Unsupported date |
|---|---|---|---|
| 1.1 | 18-05-2021 | TBD | TBD |
| 28-07-2017 | 15-06-2020 | 18-05-2022 |
* = This version has never been released in this new system. Due to the fact that we were the only one that used this version, we decided that we didn't have to release it and could just remove it.