Perché usare i metodi HTTP durante le operazioni?

I metodi HTTP (GET, POST, PUT, PATCH, DELETE) determinano il tipo di azione eseguita su una risorsa sul server. Ciò garantisce:

• Chiarezza semantica: Ogni metodo indica chiaramente l’intenzione del client (ottenere, creare, aggiornare, eliminare una risorsa).
• Caching: Il metodo GET viene memorizzato nella cache per impostazione predefinita, migliorando le prestazioni. Altri metodi che modificano lo stato di solito non vengono memorizzati nella cache.
• Idempotenza: Alcuni metodi (GET, PUT, DELETE) sono idempotenti, cioè eseguire la stessa operazione più volte produce lo stesso risultato di eseguirla una sola volta. Questo è importante per affidabilità e tentativi ripetuti. POST non è idempotente.
• Sicurezza: La separazione dei metodi aiuta a implementare politiche di sicurezza, limitando l’accesso a determinate operazioni.
• Standardizzazione: L’uso di metodi standard semplifica l’interazione tra sistemi e strumenti diversi.
• Monitoraggio degli errori: I codici di stato HTTP (ad esempio, 200 OK, 404 Not Found) sono più informativi nel contesto di un metodo specifico, indicando il risultato della richiesta.

Esempio:

import requests

# Ottenere una risorsa
response_get = requests.get("https://api.example.com/users/123")
print(f"Stato GET: {response_get.status_code}")

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

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

# Aggiornamento parziale della risorsa
data_patch = {"email": "jane.doe.updated@example.com"}
response_patch = requests.patch("https://api.example.com/users/123", json=data_patch)
print(f"Stato PATCH: {response_patch.status_code}")

# Eliminare una risorsa
response_delete = requests.delete("https://api.example.com/users/123")
print(f"Stato DELETE: {response_delete.status_code}")