Die API wird immer weiter entwickelt und der aktuelle Stand wird hier festgehalten. Die Änderungen an der API werden während der Entwicklung nicht immer abwärtskompatibel sein, weswegen wir eine Versionierung eingeführt haben. Die angefragte Version MUSS im Request-Header angegeben werden:
Accept: application/vnd.api+json, application/vnd.api+json; net.youthweb.api.version=0.20
Support
Nach dem Release einer neuen Version garantieren wir den Support der Version ohne Breaking Changes für mindestens 1 Jahr. Mindestens 6 Monaten nach dem Release und der Verfügbarkeit einer neueren Version wird eine Warnung in jedem Response angezeigt. Wenn der Support für eine Version abgelaufen ist, kann sie nicht mehr verwendet werden und ein Request zu dieser veralteten Version wird einen 406 Not Acceptable-Error zurückgeben.
Versions-Übersicht
| Version | Status | Veröffentlicht | Unterstützt bis |
|---|---|---|---|
| next |  |
- | - |
| 0.20 |  |
2021-07-25 | mindestens 2022-07-25 |
| 0.19 | |
2021-05-30 | mindestens 2022-05-30 |
| 0.18 | |
2021-02-21 | mindestens 2022-02-21 |
| 0.17 |  |
2020-08-23 | mindestens 2021-08-23 |
| 0.16 | |
2020-07-26 | mindestens 2021-07-26 |
| 0.15 |  |
2019-09-08 | Version 0.18 - 2021-02-21 |
| 0.14 | |
2019-01-13 | Version 0.16 - 2020-07-26 |
| 0.13 | |
2018-12-16 | Version 0.16 - 2020-07-26 |
Status-Legende
-
uncompleted: noch in Arbeit befindliche Version
-
supported: unterstützte Version
-
deprecated: veraltete, aber unterstütze Version, die eine Warnung in jedem Response anzeigt
-
unsupported: nicht mehr unterstützte Version, die einen 406-Error zurückgibt