Prompt này hỗ trợ bạn biến mã nguồn backend hiện có thành tài liệu API REST dễ đọc, có cấu trúc rõ ràng và đủ chi tiết để phục vụ phát triển, kiểm thử hoặc tích hợp hệ thống. Thay vì mô tả thủ công từng endpoint, bạn có thể yêu cầu AI phân tích route, controller, model, validation và middleware để tạo tài liệu đồng nhất hơn.
Hãy đưa vào route, controller, service, DTO/schema, middleware xác thực và ví dụ response nếu có. Nếu code quá dài, chia theo module như auth, user, order, payment để AI phân tích chính xác hơn.
Bạn có thể yêu cầu AI xuất tài liệu theo bảng, danh sách, Markdown thuần hoặc cấu trúc gần với OpenAPI. Nếu cần dùng nội bộ, hãy yêu cầu văn phong ngắn gọn; nếu dùng cho đối tác, hãy yêu cầu giải thích thân thiện hơn.
Với các endpoint thiếu validation, response mẫu hoặc quy tắc lỗi, nên yêu cầu AI đánh dấu giả định thay vì tự suy diễn. Điều này giúp giảm rủi ro khi tài liệu được dùng cho tích hợp thật.
Bạn có thể thêm các yêu cầu như: luôn ghi method trước path, nêu rõ quyền truy cập, mô tả kiểu dữ liệu, trường bắt buộc, ví dụ request/response, và tách riêng lỗi nghiệp vụ với lỗi hệ thống.
