Szkolenie Projektowanie, testowanie i utrzymanie REST API z Insomnia
Poziom
PodstawowyCzas
16h / 2 dniTermin
IndywidualnieCena
IndywidualnieSzkolenie Projektowanie, testowanie i utrzymanie REST API z Insomnia
Szkolenie dedykowane zespołom programistycznym, QA oraz DevOps, które projektują, rozwijają lub integrują się z interfejsami API. Celem warsztatu jest przekazanie praktycznych umiejętności w zakresie projektowania stabilnych i czytelnych REST API, ich testowania oraz utrzymania w cyklu życia oprogramowania. W trakcie intensywnych, dwudniowych warsztatów (80% praktyki), uczestnicy nauczą się korzystać z narzędzia Insomnia do projektowania żądań, automatyzacji testów, przygotowania dokumentacji (OpenAPI), mockowania oraz integracji z CI/CD. Szkolenie uzupełnia blok dobrych praktyk dotyczących bezpieczeństwa, zgodności i skalowalności interfejsów API w środowiskach produkcyjnych. Nie jest wymagane wcześniejsze doświadczenie z Insomnia – wszystkie narzędzia i procesy omawiane są od podstaw. Szkolenie może być zrealizowane w formule zamkniętej – z dopasowaniem zakresu do specyfiki technologicznej organizacji (np. branża, typ systemów, wewnętrzne standardy API).
Programistów backendowych i frontendowych, pracujących z API
Czego nauczysz się na szkoleniu?
- Uczestnicy nauczą się projektować czytelne i skalowalne REST API zgodnie z dobrymi praktykami
- Zdobędą umiejętność testowania API w sposób automatyczny z wykorzystaniem Insomnia i CI/CD
- Poznają zasady bezpiecznej komunikacji API, w tym uwierzytelnianie, walidację i kontrolę dostępu
- Będą potrafili przygotować i utrzymać dokumentację API (OpenAPI) oraz mocki do testów i integracji
Program szkolenia
Wprowadzenie do REST API
- Czym jest API i architektura REST
- Przykłady zastosowań API
- REST vs GraphQL vs SOAP
Podstawy HTTP
- Klient–serwer, bezstanowość, cache
- Metody HTTP: GET, POST, PUT, DELETE, PATCH
- Statusy odpowiedzi: 2xx, 4xx, 5xx
- Nagłówki HTTP: Content-Type, Accept, Authorization, Cache-Control
- Bezpieczeństwo: HTTPS, CORS
- Format danych JSON – składnia, dobre praktyki
Projektowanie REST API
- Identyfikacja zasobów (resources)
- RESTful URIs i dobre praktyki nazewnictwa
- Użycie metod HTTP zgodnie z semantyką
- Obsługa błędów i konwencje komunikatów
- Filtrowanie, sortowanie, paginacja, wersjonowanie API
- Założenia REST a praktyka – kompromisy
Wprowadzenie do Insomnia
- Czym jest Insomnia – porównanie z Postmanem
- Instalacja i przegląd interfejsu
- Tworzenie requestów (GET/POST itd.)
- Organizowanie workspace i folderów
- Importowanie i eksportowanie kolekcji
Praca z Insomnia – podstawy
- Parametry: query parameters, path variables, headers, body (JSON)
- Autoryzacja: Basic Auth, Bearer Token, OAuth2
- Zarządzanie środowiskami i zmiennymi
Projekt warsztatowy: API użytkowników
- Projektowanie endpointów
- Tworzenie kolekcji Insomnia
- Wysyłanie żądań, analiza odpowiedzi
- Symulacja błędów, testy poprawności
Testowanie API w Insomnia
- Asercje na statusy, nagłówki, dane
- Testy sekwencyjne (chaining requests)
- Skrypty przed-requestem i po (Insomnia Hooks)
- Dane dynamiczne i zmienne środowiskowe
Dokumentacja REST API
- OpenAPI (Swagger) – podstawy i integracja z Insomnia
- Generowanie dokumentacji
- Komentarze, opisy, struktura projektu
- Udostępnianie API – export, sharable link, OpenAPI
Automatyzacja i CI
- Debugowanie i logi w Insomnia
- Insomnia CLI (inso) – uruchamianie testów z linii komend
- Integracja z CI/CD: GitHub Actions, GitLab CI, Jenkins
- Testy regresji i smoke tests
- Mockowanie API (Insomnia Designer)
Bezpieczeństwo REST API
- Autoryzacja i uwierzytelnianie: Basic Auth, Token, OAuth2
- Ochrona: rate limiting, throttling
- Dobre praktyki: walidacja, CORS, ograniczenia metod
Utrzymanie i rozwój REST API
- Wersjonowanie i kompatybilność
- Deprecjacja i migracje
- Testy zgodności
- Organizacja projektu, konwencje nazw, środowiska
Dobre i złe praktyki
- Przypadki z życia: co działa, a co nie
- Czytelność i użyteczność API
- Antywzorce i jak ich unikać
Podsumowanie
- Checklisty REST API
- Rekomendowane narzędzia i źródła
- Sesja pytań i odpowiedzi
- Przykładowy projekt i plik OpenAPI
