Eine Swagger-Spezifikation (seit 3.0 OpenAPI Spezification) ist heute der übliche Weg, eine HTTP API zu dokumentieren und Anwendungsentwicklern zur Verfügung zu stellen. Der Artikel sollte auf keinen Fall gelöscht, allerdings überarbeitet werden. Eine HTTP API ist per se ressourcenorientiert und nicht serviceorientiert. Von daher ist der Begriff Webservice nicht passend. Außerdem bietet Swagger keine Möglichkeit, Hypermedia-Referenzen zu spezifizieren, wodurch eine API, die ausschließlich mit Swagger dokumentiert ist, zunächst nicht RESTful sein kann. (nicht signierter Beitrag von Alexander FBC (Diskussion | Beiträge) 06:09, 28. Okt. 2019 (CET))--Alexander FBC (Diskussion) 20:43, 29. Okt. 2019 (CET)