Swagger kills Hypermedia! Nimm kein REST #6

Swagger bringt viele Vorteile, verhindert aber Hypermedia und schadet somit langfristig REST. Mit Swagger bzw. Open API beschriebene Schnittstellen bieten dem Entwickler einigen Komfort wie z.B. die interaktive HTML Dokumentation in der Swagger UI oder Code Generatoren, die Client Bibliotheken für alle gängigen Programmiersprachen wie Java, C#, Ruby oder JavaScript erzeugen können. Swagger arbeitet mit URI Templates wie z.B. /produkte/{pid} anstatt mit richtigen Hyperlinks. Der Client Programmierer muss dann nur noch die pid angeben und keine vollständige URL, um eine Resource anzusprechen. Überhaupt tauchen Ressourcen in mit Swagger erzeugten Clients nicht mehr auf. Mit Swagger sieht der REST Code eines Clients so aus wie der eines SOAP Web Services oder CORBA Clients. Der Entwickler ist vollkommen von der Netzwerkschicht abgeschirmt und kommt mit Ressource, Status Codes oder Header-Feldern nicht mehr in Berührung. Swagger wird immer populärer und damit verschwindet REST auf der Clientseite. Danach wird man sich die Frage stellen, warum man noch REST auf der Serverseite verwendet und dies dann vielleicht auch in Frage stellen.

Unsere Schulungen zu REST:

Einführung in REST API

API Design mit REST und Swagger

[tonydark]

Thanks for this informative video. The problem is well formulated: 'Swagger kills hypermedia'. But what's the solution. What should be used as alternative for swagger? The problem is clear - what about the solution?

[meisterkeks]

einfach 09:16 meines Lebens verschwendet. Ich weiß nicht wie du das heute siehst, aber ich hoffe einfach mal das du mittlerweile gemerkt hast, dass das etwas Mist ist was du da erzählst. Ja ich stimme dir zu Rest war früher nicht so wie es jetzt ist, aber sowas ist normal. Ich meine ein Cookie war früher auch nicht so fortgeschritten wie er jetzt ist. Selbst du warst mal nicht so fortgeschritten wie du es jetzt bist, und das ist doch auch Ok weil alles und jeder entwickelt sich weiter. Außerdem bedenke mal das wenn man alleine IDs zurück gibt und der Client sich dann die URI selber baut, der Client die Nachricht über das mobile Netz schneller empfangen kann und nicht auf diese dummen unnötigen Bytes warten muss obwohl er sie doch eh schon kennt. Naja wie dem auch sei ich hoffe einfach das du mittlerweile auch verstanden hast das swagger mittlerweile ein guter Standart für gute und vor allem performante RestAPIs ist.

[MrKiraBR]

Why title it in englsh if you speak another language?