API Wildwuchs
Ohai,
ich stoße gerade einmal wieder zu thekno, weil ich damit vielleicht eine kleine selbst-gehostete privat-Podcast-Plattform umsetzen will.
Dabei fielen mir ein paar Dinge auf. Die API-Doku in docs/apis scheint seit meinem Weggang nicht mehr angerührt worden zu sein. Gleichzeitig sind aber eine ganze Reihe an neuen Feldern und scheinbar auch Endpunkte hinzugekommen.
Series (Beispiel Beatbetrieb) hat jetzt ein references
Field. Dort hätte man wahrscheinlich sinnvoll den Namen und das Format aus der Environment-Config übernehmen können. Außerdem kann sie active
sein. Da fehlt das Verb-Prefix wie anderwo in der API üblich (hier is_
). Außerdem weiß ich nicht, warum der Eintrag bei active == False
überhaupt auftauchen sollte.
Broadcast (Beispiel Tanztee No. 50502) hat jetzt ein series
Attribute in dem die Daten der Series nochmal enthalten sind, obwohl die über den Series Endpunkt zur Verfügung stehen. Die series_id
fehlt, obwohl sie Teil der API-Doku ist. Außerdem gibt es ein firstrun
Attribut, dass wohl eine Referenz auf einen anderen Broadcast ist. Der Code in Thekno lässt mich vermuten, dass auch dort keine Referenz genutzt wird. Ist das die Erstausstrahlung der Sendung?
Recordings (Beispiel Phlegmaexpress) hat broadcasts
statt der broadcast_ids
(wieder mit Datenduplizierung). Das gleiche Ding mit categories
, ein Baum, bei dem scheinbar sogar die parent-Beziehungen aufgelöst werden. Dazu kommt creators
, im konkreten Fall eine leere Liste, und externalcreators
, das scheinbar nullable ist? Audiotracks haben jetzt eine position
, deren Sinn sich mir nicht erschließt, weil das Backend freie Hand bei der Sortierung der Liste hat.
Ich hatte mir damals viel Mühe gegeben, dass die API wenig bis keine Daten dupliziert und viel Zeit in die Doku gesteckt, damit sich thekno auch anderswo und anderweitig verwenden lässt. Aber ich will auch nicht nur meckern ohne Handlungsvorschlag. Wollen wir mal irgendwie einen API-Marathon machen? Es würde mich freuen, wenn wir die API inkl. Doku mit ggf. neuen Anforderungen an thekno in Einklang bringen.