Miért használjunk HTTP-módszereket műveletek végrehajtásakor?

A HTTP-módszerek (GET, POST, PUT, PATCH, DELETE) meghatározzák, hogy milyen típusú művelet történik egy erőforráson a szerveren. Ez biztosítja:

• Szemantikai világosság: Minden módszer egyértelműen jelzi az ügyfél szándékát (erőforrás lekérése, létrehozása, frissítése, törlése).
• Gyorsítótárazás: A GET módszer alapértelmezés szerint cache-elt, ez javítja a teljesítményt. A többi, állapotot módosító módszer általában nem cache-elt.
• Idempotencia: Néhány módszer (GET, PUT, DELETE) idempotens, azaz ugyanazt az műveletet többszöri végrehajtás ugyanazt az eredményt adja, mint egyszeri végrehajtás. Ez fontos a megbízhatóság és az ismételt próbálkozások szempontjából. A POST nem idempotens.
• Biztonság: A módszerek szétválasztása segít a biztonsági politikák megvalósításában, korlátozva bizonyos műveletekhez való hozzáférést.
• Szabványosítás: A szabványos módszerek használata egyszerűsíti a különböző rendszerek és eszközök közötti kommunikációt.
• Hibakeresés: A HTTP státuszkódok (pl. 200 OK, 404 Not Found) informatívabbak egy adott módszer kontextusában, jelezve a kérés eredményét.

Példa:

import requests

# Erőforrás lekérése
response_get = requests.get("https://api.example.com/users/123")
print(f"GET Állapot: {response_get.status_code}")

# Erőforrás létrehozása
data_post = {"name": "John Doe", "email": "john.doe@example.com"}
response_post = requests.post("https://api.example.com/users", json=data_post)
print(f"POST Állapot: {response_post.status_code}")

# Erőforrás frissítése
data_put = {"name": "Jane Doe"}
response_put = requests.put("https://api.example.com/users/123", json=data_put)
print(f"PUT Állapot: {response_put.status_code}")

# Részleges frissítés
data_patch = {"email": "jane.doe.updated@example.com"}
response_patch = requests.patch("https://api.example.com/users/123", json=data_patch)
print(f"PATCH Állapot: {response_patch.status_code}")

# Erőforrás törlése
response_delete = requests.delete("https://api.example.com/users/123")
print(f"DELETE Állapot: {response_delete.status_code}")