تصميم API موثوقة وأدلة الإنتاج

from typing import Annotated
from fastapi import FastAPI, Header, HTTPException
from fastapi.testclient import TestClient
from pydantic import BaseModel
class Command(BaseModel):
    name: str
receipts = {}
app = FastAPI()
@app.post("/lab-items", status_code=201)
def create(command: Command, key: Annotated[str, Header(alias="Idempotency-Key", min_length=1, max_length=40)]):
    if key in receipts:
        saved = receipts[key]
        if saved["name"] != command.name: raise HTTPException(status_code=409, detail="Key conflict")
        return {"id": saved["id"]}
    receipts[key] = {"id": len(receipts) + 1, "name": command.name}
    return {"id": receipts[key]["id"]}
with TestClient(app) as client:
    headers = {"Idempotency-Key": "lab-a"}
    print(client.post("/lab-items", headers=headers, json={"name": "pen"}).json())
    print(client.post("/lab-items", headers=headers, json={"name": "pen"}).json())
    print(client.post("/lab-items", headers=headers, json={"name": "book"}).status_code)

{'id': 1}
{'id': 1}
409

يعيد المتطابق 1 ويتعارض المختلف؛ والخريطة نموذج متسلسل لا ديمومة أوتزامن إنتاج.

from fastapi import FastAPI, Response
from fastapi.testclient import TestClient
state = {"mode": "starting"}
app = FastAPI()
@app.get("/ready")
def ready():
    return Response(status_code=200 if state["mode"] == "ready" else 503)
with TestClient(app) as client:
    print(client.get("/ready").status_code)
    state["mode"] = "ready"
    print(client.get("/ready").status_code)
    state["mode"] = "draining"
    print(client.get("/ready").status_code)

503
200
503

تعيد البداية والتصريف 503 والجاهزة 200 دون إيقاف عملية أواستعلام منصة أواعتماد.