Youthweb-API 0.21 lädt Relationships nur noch mit include. Die Versionen 0.16 und 0.17 antworten mit 406, 0.18 bis 0.20 sind veraltet.

Relationships nur noch mit include

Bei Events, Posts und Friends hat die API bisher einen Teil der Relationships automatisch mitgeladen. Das haben wir seit 0.16 angekündigt. Ab 0.21 gibt es das nicht mehr. Die Antworten werden dadurch kleiner, und included und die Warnung in meta.warnings entfallen, solange du nichts anforderst.

Resource Früher automatisch Jetzt mit
Events author ?include=author
Posts parent, author ?include=author,parent
Friends from, to ?include=from,to

Request

GET https://api.youthweb.net/events/1234?include=author
Accept: application/vnd.api+json, application/vnd.api+json; net.youthweb.api.version=0.21
Content-Type: application/vnd.api+json

Auch die Antwort von PATCH /posts/{post_id} enthält kein included mehr. Die Versionen 0.20 und älter verhalten sich unverändert.

Versionen 0.16 und 0.17 werden gesperrt

Die Versionen 0.16 und 0.17 zeigen seit 2021 eine Warnung in jedem Response. Mit dem Release von 0.21 sind sie nicht mehr nutzbar. Ein Request mit diesen Versionen antwortet mit 406 Not Acceptable.

Versionen 0.18, 0.19 und 0.20 sind veraltet

Ab dem Release von 0.21 am 2026-11-21 zeigen die Versionen 0.18, 0.19 und 0.20 in jedem Response eine Warnung. 0.18 und 0.19 werden mindestens bis zum 2027-05-21 unterstützt, 0.20 mindestens bis zum 2027-11-21. Danach können sie mit dem Release einer neuen Version gesperrt werden. Wir kündigen den genauen Zeitpunkt vorher an.

Was musst du tun?

Stelle deine Anwendung auf die aktuelle Version 0.21 um und sende sie im Accept-Header:

Accept: application/vnd.api+json, application/vnd.api+json; net.youthweb.api.version=0.21

Fordere die Relationships, die du brauchst, mit dem include Parameter im Querystring an.

Welche Version wie lange unterstützt wird, steht in der Versions-Übersicht.