Giả lập một API HTTP

Nhấp chuột phải lên một thư mục ▸ Thêm ▸ Máy chủ HTTP.

Cấu hình

Một máy chủ được cấu hình bằng đúng những trường của một yêu cầu — và đó chính là điểm hay: phương thức và đường dẫn xác định tuyến được lắng nghe, còn mã trạng thái, header và thân xác định phản hồi được phục vụ.

Trường	Vai trò
Phương thức	Phương thức của tuyến
Địa chỉ	`localhost:<port><chemin>` — host bị cố định
Mã trạng thái giả lập	Mã được trả về, mặc định là `200`
Header	Các header của phản hồi
Thân	Thân của phản hồi

Một phần tử Máy chủ HTTP: URL rút gọn còn localhost + cổng + đường dẫn, phương thức được phục vụ, các header và thân của phản hồi giả lập

Định tuyến

Một tuyến là một cặp phương thức + đường dẫn. Việc ghép cặp dựa trên đường dẫn chính xác, còn chuỗi truy vấn thì bị bỏ qua. Mọi lời gọi đến cổng mà không khớp tuyến nào sẽ nhận về 404.

Hai tuyến chỉ va chạm nhau nếu chúng dùng chung phương thức, chung đường dẫn và chung cổng. Vì vậy bạn có thể tạo một yêu cầu máy chủ cho mỗi tuyến rồi khởi động tất cả.

GET  localhost:8080/clients      → 200, danh sách khách hàng
GET  localhost:8080/clients/42   → 200, một khách hàng
POST localhost:8080/clients      → 201, header Location
GET  localhost:8080/clients/999  → 404 (không có tuyến: phản hồi mặc định)

Các mẫu

Header và thân được giải quyết ở mỗi lời gọi đi vào. Vì vậy một phần thân chứa {{maintenant}} hay {{compteur}} sẽ thay đổi từ lời gọi này sang lời gọi khác nếu biến thay đổi.

Mẹo: điều này cho phép điều khiển hành vi của máy chủ ngay trong lúc nó đang chạy — hãy đổi giá trị của một biến môi trường và lời gọi kế tiếp sẽ nhận được một phản hồi khác, mà không cần khởi động lại.

Dùng chung cổng

Một máy chủ HTTP giả lập và một máy chủ WebSocket hoặc Socket.IO có thể lắng nghe trên cùng một cổng: Restorm định tuyến các yêu cầu thông thường tới các tuyến HTTP và các yêu cầu nâng cấp tới máy chủ thời gian thực.

Trong một kịch bản

Hành động Máy chủ HTTP lưu trữ tuyến trong suốt thời gian chạy kịch bản và phát ra một sự kiện served — mang theo { request, response } — cho mỗi lời gọi nhận được. Đây là cách kiểm thử một webhook:

Máy chủ HTTP ──connected──► Yêu cầu HTTP « kích hoạt webhook »
     └────────served──────► Khẳng định trên request.body
                              rồi ──► Đóng máy chủ HTTP

Xem Máy chủ được lưu trữ.