Projektowanie RESTful API z OpenAPI i Swagger

Dobrze zaprojektowane interfejsy API stanowią podstawę nowoczesnej architektury oprogramowania. Bez jasnej dokumentacji są one jednak trudne do zintegrowania i utrzymania. Nauka tworzenia standardowych, czytelnych dla komputera specyfikacji jest kluczem do tworzenia skalowalnych i przyjaznych dla programistów interfejsów API. Ten kurs tekstowy przeprowadzi Cię przez proces projektowania, dokumentowania i zabezpieczania interfejsów API RESTful przy użyciu standardowej specyfikacji OpenAPI (dawniej Swagger).Będziesz przechodzić od zrozumienia podstawowych koncepcji HTTP do pisania gotowych do produkcji specyfikacji API w YAML, które można wykorzystać do generowania interaktywnej dokumentacji, serwerów próbnych i zestawów SDK klienta. Czego się nauczysz: - Zrozum podstawowe koncepcje HTTP, zasady RESTful i sposób, w jaki OpenAPI pasuje do nowoczesnego cyklu życia rozwoju. - Napisz czyste, uporządkowane specyfikacje API za pomocą narzędzi YAML i Swagger. - Zdefiniuj ścieżki API, parametry i operacje HTTP, takie jak GET, POST, PUT i DELETE. - Twórz schematy wielokrotnego użytku i modele danych za pomocą schematu JSON, aby zapewnić ścisłą walidację danych. - Skonfiguruj solidne schematy bezpieczeństwa API, w tym klucze API, tokeny nośne i przepływy OAuth2. - Zastosuj najlepsze praktyki zarządzania API, sprawdzając specyfikacje pod kątem spójności i jakości. Zaczniesz od podstawowych elementów składowych usług internetowych i HTTP, zanim zanurzysz się w praktyczne pisanie specyfikacji.W miarę postępów będziesz badać zaawansowane tematy, takie jak komponenty wielokrotnego użytku, definicje bezpieczeństwa i nowoczesne narzędzia do generowania interaktywnej dokumentacji. Ten kurs jest przeznaczony dla początkujących, w tym programistów, pisarzy technicznych i menedżerów produktów, którzy chcą opanować projektowanie interfejsów API.Nie jest wymagane wcześniejsze doświadczenie z OpenAPI lub Swagger, chociaż pomocna jest podstawowa znajomość JSON lub YAML. Zacznij pisać jasne, profesjonalne specyfikacje API już dziś.