Ràng buộc Tham số Đường dẫn & Regex Mã Đơn hàng (Path Parameter Regex Constraints)

Mục tiêu kiến thức

• Áp dụng Path(..., pattern=...) trong FastAPI để kiểm tra định dạng tham số URL trước khi vào controller.
• Xử lý mã lỗi HTTP 422 Unprocessable Entity khi tham số sai cấu trúc.

Mô tả bài toán

Viết hàm create_order_lookup_app() -> FastAPI: Định nghĩa endpoint: GET /orders/{order_code}:

• Tham số order_code: str nhận từ đường dẫn (Path parameter).
• Ràng buộc order_code phải khớp biểu thức chính quy:

^ORD-[0-9]{4}-[A-Z]{3}$ (Ví dụ hợp lệ: ORD-2026-ABC, ORD-1999-XYZ; không hợp lệ: ORD-26-A, ord-2026-abc, 12345).

• Nếu hợp lệ: trả về JSON:

{"order_code": order_code, "status": "CONFIRMED", "valid": True}.

• Nếu không khớp regex: FastAPI tự động trả về mã lỗi 422 Unprocessable Entity.

Ràng buộc

• Thời gian chạy tối đa: 1000ms.
• Giới hạn bộ nhớ: 256MB.
• Dữ liệu đầu vào tuân thủ đúng kiểu dữ liệu và miền giá trị được mô tả.