Prečo používať HTTP metódy pri vykonávaní operácií?

Metódy HTTP (GET, POST, PUT, PATCH, DELETE) určujú typ akcie, ktorá sa vykonáva na zdroji na serveri. To zabezpečuje:

• Sémantickú jasnosť: Každá metóda jasne uvádza zámer klienta (získať, vytvoriť, aktualizovať, odstrániť zdroj).
• Cacheovanie: Metóda GET je predvolene cacheovaná, čo zlepšuje výkon. Ostatné metódy, ktoré menia stav, sa zvyčajne necacheujú.
• Idempotentnosť: Niektoré metódy (GET, PUT, DELETE) sú idempotentné, teda opakované vykonanie rovnakej operácie dá rovnaký výsledok ako jej vykonanie raz. To je dôležité pre spoľahlivosť a opakovateľné pokusy. POST nie je idempotentný.
• Bezpečnosť: Rozdelenie metód pomáha pri implementácii bezpečnostných politík, obmedzujúc prístup k určitým operáciám.
• Štandardizácia: Použitie štandardných metód zjednodušuje komunikáciu medzi rôznymi systémami a nástrojmi.
• Sledovanie chýb: Kódy stavu HTTP (napríklad 200 OK, 404 Not Found) sú informatívnejšie v kontexte konkrétnej metódy, ukazujúc výsledok požiadavky.

Príklad:

import requests

# Získanie zdroja
response_get = requests.get("https://api.example.com/users/123")
print(f"Stav GET: {response_get.status_code}")

# Vytvorenie zdroja
data_post = {"name": "John Doe", "email": "john.doe@example.com"}
response_post = requests.post("https://api.example.com/users", json=data_post)
print(f"Stav POST: {response_post.status_code}")

# Aktualizácia zdroja
data_put = {"name": "Jane Doe"}
response_put = requests.put("https://api.example.com/users/123", json=data_put)
print(f"Stav PUT: {response_put.status_code}")

# Čiastočná aktualizácia zdroja
data_patch = {"email": "jane.doe.updated@example.com"}
response_patch = requests.patch("https://api.example.com/users/123", json=data_patch)
print(f"Stav PATCH: {response_patch.status_code}")

# Odstránenie zdroja
response_delete = requests.delete("https://api.example.com/users/123")
print(f"Stav DELETE: {response_delete.status_code}")