Konvence pro použití HTTP metod
V následující tabulce je popsáno, jaké HTTP metody použít pro různé scénáře.
| Metoda | Způsob použití |
|---|---|
| GET | Stažení dat |
| POST | Vytvoření záznamu |
HTTP stavové kódy
V tabulce níže je přehled HTTP stavových kódů, které API vrací v uvedených případech.
| Kód | Název | Význam |
|---|---|---|
200 |
OK |
Úspěšné zpracování požadavku |
201 |
Created |
Úspěšné zpracování požadavku |
400 |
Bad Request |
Neplatný požadavek |
401 |
Unauthorized |
Neplatné autentizační údaje |
403 |
Forbidden |
Nedostatečná práva pro provedení operace |
404 |
Not Found |
Nenalezeno (záznam, API metoda, ...) |
405 |
Method Not Allowed |
Nepodporovaná HTTP metoda |
422 |
Too Many Requests |
Vyčerpán limit požadavků |
429 |
Unprocessable Entity |
Nezpracovatelná entita (např. entita neprošla validací) |
500 |
Internal Server Error |
Neočekávaná chyba |
503 |
Service Unavailable |
Server je nedostupný |