Definicja
API (Application Programming Interface) to zestaw reguł i endpointów umożliwiających komunikację między dwoma systemami.
Typy API
| Typ | Opis | Zastosowanie |
|---|---|---|
| REST | HTTP + JSON, bezstanowe | Webowe API, SaaS |
| GraphQL | Jeden endpoint, klient definiuje strukturę | Złożone frontendy |
| SOAP | XML, ścisły kontrakt (WSDL) | Enterprise, bankowość |
| gRPC | Protocol Buffers, szybkie | Mikroserwisy |
| WebSocket | Dwukierunkowe, real-time | Chat, notyfikacje |
Przykład REST API
GET /api/users → Lista użytkowników
GET /api/users/42 → Szczegóły użytkownika 42
POST /api/users → Utwórz użytkownika
PUT /api/users/42 → Zaktualizuj użytkownika 42
DELETE /api/users/42 → Usuń użytkownika 42
Dlaczego BA powinien znać API?
- Definiuje wymagania integracyjne (jakie dane, jaki format, jak często)
- Rozumie ograniczenia (rate limiting, paginacja, autoryzacja)
- Komunikuje się z zespołem technicznym (endpoint, payload, response)
- Czyta dokumentację API (Swagger/OpenAPI)