Definicja
REST (Representational State Transfer) to styl architektoniczny dla API webowych, oparty na zasobach (URLs) i standardowych metodach HTTP.
Metody HTTP
| Metoda |
Operacja CRUD |
Idempotentna? |
| GET |
Read |
Tak |
| POST |
Create |
Nie |
| PUT |
Update (całość) |
Tak |
| PATCH |
Update (częściowe) |
Nie |
| DELETE |
Delete |
Tak |
Kody odpowiedzi HTTP
| Kod |
Znaczenie |
Kiedy |
| 200 |
OK |
Sukces |
| 201 |
Created |
Zasób utworzony |
| 400 |
Bad Request |
Błąd walidacji |
| 401 |
Unauthorized |
Brak autoryzacji |
| 403 |
Forbidden |
Brak uprawnień |
| 404 |
Not Found |
Zasób nie istnieje |
| 500 |
Internal Server Error |
Błąd serwera |
RESTful design — zasady
- URL = rzeczowniki (
/users, nie /getUsers)
- Metody HTTP = czasowniki (GET/POST/PUT/DELETE)
- Bezstanowość — każde żądanie zawiera pełny kontekst
- JSON jako domyślny format
Powiązane pojęcia
