Codzy

Web: una mini API JSON

Un'API web è un programma che risponde alle richieste con dei dati, quasi sempre in JSON. Si organizza in rotte: un metodo + un percorso (es. GET /tasks/2) attivano una funzione, che restituisce un codice di stato e un contenuto.

È esattamente ciò che fanno FastAPI o Flask, con in più la rete. Le buone abitudini: 200 quando va tutto bene, 404 se la risorsa non esiste, 405 se il metodo non è consentito, e sempre una risposta JSON leggibile, anche per un errore. json.dumps trasforma un oggetto Python in testo JSON.

import json

users = {1: {"name": "Lina"}, 2: {"name": "Omar"}}

def get_user(user_id):
    if user_id in users:
        return 200, users[user_id]
    return 404, {"error": "user not found"}

for uid in (1, 3):
    status, body = get_user(uid)
    print(status, json.dumps(body))

Inizia la lezione