Miks kasutada HTTP meetodeid operatsioonide teostamisel?

HTTP meetodid (GET, POST, PUT, PATCH, DELETE) määravad tegevuse tüübi, mida tehakse serveri ressursil. See tagab:

• Semantiline selgus: Iga meetod näitab selgelt kliendi kavatsust (saada, luua, uuendada, kustutada ressurss).
• Vahemälu kasutamine: GET meetod vahemällu salvestub vaikimisi, mis tõstab jõudlust. Teised meetodid, mis muudavad olekut, tavaliselt vahemällu ei salvestu:
• Idempotentsus: Mõned meetodid (GET, PUT, DELETE) on idempotentsed, see tähendab, et sama operatsiooni korduv täitmine annab sama tulemuse nagu üks kord. See on oluline usaldusväärsuse ja korduvkatsete jaoks. POST ei ole idempotent:
• Turvalisus: Meetodite jaotamine aitab rakendada turvapoliitikaid, piirates juurdepääsu teatud toimingutele:
• Standardiseerimine: Standardmeetodite kasutamine lihtsustab erinevate süsteemide ja tööriistade vahel suhtlust:
• Vigade jälgimine: HTTP olekukoodid (näiteks 200 OK, 404 Not Found) on konkreetse meetodi kontekstis informatiivsemad, näidates päringu täitmise tulemust:

Näide:

import requests

# Ressursi saamine
response_get = requests.get("https://api.example.com/users/123")
print(f"GET Staatus: {response_get.status_code}")

# Ressursi loomine
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 Staatus: {response_post.status_code}")

# Ressursi uuendamine
data_put = {"name": "Jane Doe"}
response_put = requests.put("https://api.example.com/users/123", json=data_put)
print(f"PUT Staatus: {response_put.status_code}")

# Osaline uuendamine
data_patch = {"email": "jane.doe.updated@example.com"}
response_patch = requests.patch("https://api.example.com/users/123", json=data_patch)
print(f"PATCH Staatus: {response_patch.status_code}")

# Ressursi kustutamine
response_delete = requests.delete("https://api.example.com/users/123")
print(f"DELETE Staatus: {response_delete.status_code}")