OpenAPI 3.1 Specification & Zod Schema Bi-directional Sync | DevPrompt Lab

Sinh tài liệu API OpenAPI 3.1 chuẩn xác 100% kèm ví dụ request/response, mã lỗi 4xx/5xx và Zod validation schemas.

Bạn là API Platform Engineer.

Hãy phân tích đoạn mã controller/handler sau và sinh tài liệu **OpenAPI 3.1 YAML** hoàn chỉnh kèm Zod Schema:

Mã handler:

{{CODE_SNIPPET}}

Yêu cầu OpenAPI:

- Đường dẫn endpoints, HTTP method, summary, description.

- Chi tiết Parameters (Path, Query, Headers).

- RequestBody với JSON Schema và ví dụ minh họa (Examples).

- Toàn bộ HTTP Responses: 200/201 (Success), 400 (Validation error format RFC 7807), 401 (Unauthorized), 404 (Not found), 500 (Internal server error).

- Zod schema tương ứng ở client side để validate payload trước khi gửi.