HTTP và REST

Đây là loại yêu cầu phổ biến nhất: mọi thứ nói HTTP, bắt đầu từ các API REST.

Nhấp chuột phải trong cây ▸ Thêm ▸ Yêu cầu HTTP.

Một tab yêu cầu HTTP với URL, các phần Header / Tham số đường dẫn / Tham số / Thân và bảng phản hồi ở bên phải

Phương thức

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS và QUERY.

URL

URL chấp nhận {{variables}} ở mọi vị trí — lược đồ, host, cổng, đường dẫn, chuỗi truy vấn. Giá trị đã giải quyết được hiển thị ngay dưới ô nhập.

Ba danh sách bổ sung cho URL:

các tham số truy vấn (?clé=valeur);
các tham số đường dẫn, thay thế các đoạn có tên trong đường dẫn;
các header.

Mỗi dòng đều có một ô bật/tắt, một kiểu giá trị và một phần mô tả.

Thân

Bốn họ:

Kiểu	Công dụng
Văn bản	JSON, XML, văn bản thô — có tô màu cú pháp và định dạng lại
Tệp	Gửi nội dung của một tệp trên ổ đĩa
Biểu mẫu (`multipart/form-data`)	Các trường có tên, kèm tệp
`x-www-form-urlencoded`	Các trường có tên được mã hóa trong thân

Tùy chọn

Thời gian chờ: tính bằng mili giây, riêng cho yêu cầu này; nếu không đặt, giá trị toàn cục sẽ được áp dụng.
Đi theo chuyển hướng: bật mặc định. Hãy tắt nó để quan sát chính mã 3xx và header Location của nó.

Phản hồi

Mã trạng thái, thời gian, kích thước, header, và thân được hiển thị theo kiểu nội dung của nó: trình xem JSON thu gọn được, XML thụt lề, xem trước ảnh, văn bản thô. Tab lịch sử cho phép truy cập các lần chạy trước đó.

Xác thực

Hãy gắn một tuyến xác thực vào yêu cầu để các header được chèn vào và token được gia hạn tự động. Xem Xác thực.

Chế độ máy chủ

Restorm cũng có thể lưu trữ một máy chủ HTTP, để kiểm thử cách một client tiêu thụ nó — thường là mã ứng dụng của bạn, mà bạn tạm trỏ về localhost trong lúc thử.

Hãy thêm một máy chủ bằng Thêm ▸ Máy chủ HTTP: nó lắng nghe trên localhost:<port><chemin> cho một cặp phương thức + đường dẫn và trả lời với mã trạng thái, header và thân mà bạn cấu hình ở đó. Các giao thức khác cũng được lưu trữ theo cách tương tự — xem Chế độ máy chủ và Giả lập một API HTTP.

Đoạn mã

Hai mươi bốn ngôn ngữ và thư viện được cung cấp trong tab Code Snippets: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), Node.js thuần, Go, Rust (reqwest), Java (HttpClient, OkHttp), C# (HttpClient), PHP (cURL, Guzzle), Ruby (Net::HTTP, Faraday), Swift (URLSession), Kotlin (OkHttp), Dart, R (httr), PowerShell, Elixir (HTTPoison), Clojure (clj-http).

Nhập thay vì gõ tay

Bạn có sẵn một đặc tả OpenAPI, một bộ sưu tập Postman, một tệp HAR hay chỉ một lệnh curl? Tệp ▸ Nhập sẽ dựng lại cây giúp bạn. Xem Nhập & xuất.