HTTP metode izražajo vaš namen nad virom; statusne kode so strežnikov kodirani odgovor. Za metode sta pomembni dve lastnosti: safe (samo branje, brez stranskih učinkov) in idempotent (ponavljanje da isti rezultat — pomembno za varne ponovne poskuse).
| Metoda | Namen | Safe | Idempotent |
|---|
| GET | Preberi vir | Yes | Yes |
| POST | Ustvari / sproži dejanje | No | No |
| PUT | Zamenjaj vir | No | Yes |
| PATCH | Delno posodobi | No | No* |
| DELETE | Odstrani vir | No | Yes |
| HEAD | Kot GET, samo glave | Yes | Yes |
Razlika v idempotentnosti je praktična: ker sta PUT in DELETE idempotentna, ju odjemalec lahko varno ponovi po izteku časovne omejitve; ponovni poskus neidempotentnega POST tvega ustvarjanje dvojnika (klasična napaka dvojnega bremenjenja).
Statusne kode so razvrščene po prvi števki:
1xx Informational request received, continuing (100 Continue, 101 Switching)
2xx Success it worked (200 OK, 201 Created, 204 No Content)
3xx Redirection go elsewhere (301 Moved, 304 Not Modified)
4xx Client error YOUR request is wrong (400, 401, 403, 404, 429)
5xx Server error the SERVER failed (500, 502, 503, 504)
Najpomembnejša črta je delitev 4xx proti 5xx: 4xx pomeni, da je odjemalec poslal nekaj napačnega (slab vhod, neavtenticiran, ni najdeno) — ponovni poskus brez sprememb ne bo pomagal; 5xx pomeni, da je strežnik odpovedal — ponovni poskus (z zamikom, backoff) morda uspe. Vsakdanje imejte v mezincu: 401 (neavtenticiran) proti 403 (avtenticiran, a nedovoljen), 404 (ni najdeno), 429 (omejitev pogostosti), 500 (splošno sesutje strežnika), 502/503/504 (bad gateway / nedosegljivo / gateway timeout — običajno težava v zaledju (upstream) ali preobremenitev).
Te kode so skupna pogodba med vsakim odjemalcem in strežnikom, zato se tekočnost tu pričakuje od vsakogar, ki gradi ali uporablja API-je. Izpraševalci raziskujejo razlike, ki razkrijejo pravo razumevanje: 401 proti 403, PUT proti PATCH in zlasti idempotentnost, ki neposredno ureja, ali so ponovni poskusi varni — jedrna skrb v porazdeljenih sistemih in plačilnih tokovih. Vračanje prave statusne kode naredi vaš API tudi predvidljiv in pravilno obravnavan s strani predpomnilnikov, proxyjev in odjemalskih knjižnic, zato to znanje oblikuje dobro zasnovo API-ja, ne le drobtinice.
Knjižnica IT vprašanj za razgovore s podrobnimi odgovori — od začetnika do izkušenega.
Doniraj