Nhập một tệp TypeSpec

TypeSpec (Microsoft) mô tả một API bằng một ngôn ngữ chuyên dụng, rồi biên dịch nó sang OpenAPI. Restorm đi theo đúng con đường đó.

Nhập

Tệp ▸ Nhập (Ctrl+I) rồi chọn một tệp .tsp trên ổ đĩa.

Restorm biên dịch tệp đó sang OpenAPI 3.x bằng trình biên dịch TypeSpec tích hợp sẵn, rồi chuyển kết quả cho phần nhập OpenAPI. Nhờ vậy bạn nhận được đúng cái cây phong phú như thế: thư mục theo nhãn, yêu cầu có kiểu, tài liệu, phần bảo mật đấu nối sẵn.

Mô hình tin cậy

Nội dung .tsp được sao chép vào một thư mục tạm biệt lập, nơi Restorm gắn các phụ thuộc của chính nó. Hệ quả: một tệp tspconfig.yaml hay một thư mục node_modules nằm cạnh tệp nguồn của bạn không bao giờ được đọc tới. Vì thế việc biên dịch không thể chạy mã tùy ý đến từ cây thư mục của bạn.

Giới hạn

• Chỉ tệp cục bộ. Việc dán nội dung và nhập bằng URL đều bị từ chối kèm thông báo rõ ràng.
• Đặc tả trong một tệp duy nhất. Các lệnh import tương đối tới những tệp .tsp bên cạnh sẽ không được giải quyết — đây là hệ quả trực tiếp của cơ chế biệt lập ở trên. Nếu mô hình của bạn được chia thành nhiều tệp, hãy tự biên dịch sang OpenAPI rồi nhập kết quả.