Khởi động nhanh (5 phút)

Mục tiêu: đi từ một bản cài đặt mới tinh đến một yêu cầu đã xác thực, trong đó URL và token đều đến từ biến. Bạn cần khoảng năm phút.

1. Tạo một dự án

Tệp ▸ Mới (Ctrl+N), rồi Tệp ▸ Lưu dưới dạng (Ctrl+Shift+S) để đặt tên cho nó, ví dụ demo.restorm.

Một dự án chỉ là một tệp bình thường trên ổ đĩa của bạn. Bạn có thể đặt nó vào một kho git ngay từ bây giờ — Restorm được thiết kế cho việc đó.

2. Tạo một thư mục biến

Nhấp chuột phải trong cây bên trái ▸ Thêm ▸ Thư mục môi trường.

Một thư mục biến (hay thư mục môi trường) là vật chứa mang các môi trường của bạn — local, staging, production — và do đó cả các {{variables}} của bạn. Mọi yêu cầu nằm trong đó đều kế thừa môi trường đang được chọn.

Hãy mở nó, tạo một môi trường local và thêm vào đó một biến:

Khóa	Kiểu	Giá trị
baseUrl	Chuỗi	https://api.exemple.test

3. Tạo và gửi một yêu cầu

Nhấp chuột phải vào thư mục ▸ Thêm ▸ Yêu cầu HTTP. Trong tab vừa mở ra:

• giữ nguyên phương thức GET;
• nhập URL {{baseUrl}}/health — giá trị đã giải quyết hiện ra ngay dưới ô nhập, đó là lưới an toàn của bạn;
• nhấp Send.

Phản hồi mở ra bên dưới: mã trạng thái, thời gian, kích thước, header, và phần thân được hiển thị trong một trình xem JSON có thể thu gọn.

4. Thêm phần xác thực

Thay vì dán một token cứng, hãy tạo một yêu cầu xác thực: nhấp chuột phải ▸ Thêm ▸ Yêu cầu xác thực HTTP. Cấu hình lời gọi lấy token (ví dụ một POST /oauth/token), rồi trong tab Cấu hình của nó, khai báo những gì nó tạo ra:

Header sinh ra	Giá trị
Authorization	{{token_type}} {{access_token}}

Giá trị là một biểu thức được ước lượng trên thân phản hồi của yêu cầu xác thực. Nhân tiện, hãy điền cả biểu thức thời hạn (ví dụ {{expires_in}}) để Restorm tự gia hạn token.

Quay lại yêu cầu GET của bạn và, trên thanh phía trên, chọn tuyến xác thực này. Từ giờ header sẽ được chèn vào mỗi lần gửi, và một mã 401 sẽ tự động kích hoạt việc gia hạn rồi thử lại.

Chi tiết: Xác thực.

5. Đi xa hơn

• Bạn đã có sẵn một đặc tả hoặc một bộ sưu tập? Tệp ▸ Nhập (Ctrl+I) dựng lại toàn bộ cây: xem Nhập & xuất.
• Nối chuỗi nhiều lời gọi và kiểm tra kết quả bằng một kịch bản.
• Cho kịch bản đó chạy trong CI của bạn: Chạy headless.