Phiên ghi

Một phiên ghi theo dõi một trang web trong khi bạn sử dụng nó và ghi lại mọi lời gọi API mà trang thực hiện: REST, GraphQL, gRPC-web và WebSocket. Các lời gọi được ghi lại có thể xem như những phản hồi thông thường và, trên các gói Pro và Enterprise, trở thành một thư mục gồm các yêu cầu thật, có thể chạy lại, được điền sẵn đúng những gì trang đã thực sự gửi đi.

Đây là con đường ngắn nhất để lập tài liệu cho một API mà bạn chỉ có phần giao diện: không cần cấu hình proxy, không cần cài chứng chỉ, không cần tiện ích mở rộng trình duyệt.

Tạo một phiên

Một phiên có thể được tạo ở bất kỳ đâu trong cây — ở gốc, trong một thư mục hoặc trong một thư mục môi trường — từ menu ngữ cảnh (“Thêm” → “Phiên ghi”) hoặc từ menu “Tạo”; chỉ có kịch bản là không thể chứa phiên. Phiên xuất hiện trong thanh bên dưới dạng một nút cha: nhấp vào chính phiên sẽ mở trang cấu hình của nó, còn mỗi dòng con sẽ mở tab riêng.

Trang cấu hình của một phiên ghi: url của trang, các giao thức được ghi, danh sách trắng và danh sách đen, cùng nút Bắt đầu ghi

Cấu hình gồm bốn phần:

Url của trang cần mở trong trình duyệt mini (http://, https:// hoặc file://). Nút “Bắt đầu ghi” vẫn bị vô hiệu cho đến khi url hợp lệ.
Các giao thức cần ghi: HTTP, WebSocket, GraphQL, gRPC-web — tất cả đều được chọn theo mặc định.
Danh sách trắng: các biểu thức chính quy; một lời gọi được giữ lại nếu khớp với ít nhất một trong số đó. Khi để trống, mọi lời gọi đều được cho qua.
Danh sách đen: các biểu thức chính quy; một lời gọi khớp với bất kỳ mục nào sẽ bị loại. Danh sách đen luôn có quyền quyết định cuối cùng.

Chỉ các thiết lập này và các tuyến đã suy ra được lưu vào tệp dự án. Các lời gọi đã ghi thì chỉ nằm trong bộ nhớ: chúng biến mất khi đóng dự án và không bao giờ được ghi xuống đĩa.

Ghi

Nút “Bắt đầu ghi” mở trang trong một tab trình duyệt mini và gắn bộ ghi trước lần tải đầu tiên, nhờ đó các lời gọi mà trang thực hiện khi khởi động — kể cả một kết nối WebSocket được mở ngay lập tức — đều được ghi lại. Một vầng sáng nhấp nháy quanh huy hiệu của phiên trong thanh bên, và quanh tab của nó, cho biết quá trình ghi đang chạy.

Trình duyệt mini trong khi ghi: trang của website, các nút Tạm dừng ghi và Dừng ghi trên dòng địa chỉ, huy hiệu đỏ trên phiên

Hãy duyệt và sử dụng trang như bình thường. Hai nút trên dòng địa chỉ điều khiển phiên:

Tạm dừng ghi giữ trang mở nhưng không lưu lời gọi nữa — tiện khi muốn bỏ qua một màn hình không đáng quan tâm.
Dừng ghi gỡ bộ ghi và đóng tab trình duyệt. Các bản ghi vẫn còn sẵn để xem.

Ghi luôn là một hành động chủ động: một tab trình duyệt được khôi phục khi mở lại ứng dụng sẽ không ghi gì cả.

Các trang web cần vị trí của bạn sẽ hỏi trình duyệt, và theo mặc định trình duyệt mini không tiết lộ gì cả. Thiết lập Chia sẻ vị trí của bạn với trình duyệt nhúng, trong mục Quyền riêng tư của phần thiết lập ứng dụng và tắt theo mặc định, cung cấp vị trí gần đúng của bạn sau khi hỏi ý kiến đồng ý — từ dịch vụ định vị của hệ thống, nếu không có thì từ ước tính ở cấp thành phố dựa trên địa chỉ IP của bạn. Khi tắt, vị trí sẽ bị quên ngay lập tức.

Bản ghi

Dòng “Bản ghi” của phiên mở chế độ xem các lời gọi, được nhóm theo lần chạy từ cũ nhất đến mới nhất và cập nhật trực tiếp trong khi ghi. Khi danh sách đang được cuộn xuống tận cuối, nó sẽ đi theo các lời gọi mới nhất; cuộn lên để đọc một lời gọi và danh sách sẽ đứng yên. Một ô lọc giúp thu hẹp danh sách; chi tiết của một lời gọi dùng lại đúng các tab phản hồi của yêu cầu (nội dung, thông tin, cookie, đồ thị), theo từng giao thức.

Chế độ xem bản ghi: danh sách lời gọi được nhóm theo lần chạy ở bên trái, chi tiết của lời gọi được chọn ở bên phải cùng các tab phản hồi

Menu ngữ cảnh của một lời gọi cho phép thêm nó vào danh sách trắng hoặc danh sách đen, với url của nó được điền sẵn làm mẫu. Bạn có thể áp dụng mẫu mới cho các lời gọi đã ghi: những lời gọi không còn qua được sẽ bị xóa vĩnh viễn — ứng dụng sẽ hỏi xác nhận.

Số lời gọi được giữ lại cho mỗi phiên có giới hạn (mặc định 1.000, có thể điều chỉnh trong thiết lập ứng dụng); vượt quá giới hạn, những lời gọi cũ nhất sẽ bị xóa.

Suy ra các tuyến

Trên các gói Pro và Enterprise, nút Suy ra các tuyến trong chế độ xem bản ghi biến các lời gọi thành một cây bên dưới dòng “Tuyến” của phiên:

các lời gọi được nhóm theo tuyến: một đoạn đường dẫn thay đổi giữa các lời gọi (/pets/1, /pets/2) trở thành tham số đường dẫn {{petId}};
các thư mục đi theo các tiền tố tĩnh của đường dẫn (api › pets); các lời gọi gRPC-web được xếp theo dịch vụ;
mỗi tuyến trở thành một yêu cầu thông thường — HTTP, GraphQL, gRPC-web hoặc WebSocket — được điền sẵn từ lời gọi thành công gần nhất (header, tham số, nội dung) và có thể chạy lại ngay lập tức;
các lời gọi đã ghi được đưa vào lịch sử phản hồi của từng yêu cầu, theo định dạng thông thường và trong giới hạn lưu giữ đã cấu hình; phản hồi hiển thị mặc định là của lời gọi thành công gần nhất.

Dòng Tuyến của phiên được mở rộng: các thư mục đã suy ra và các yêu cầu của chúng, sẵn sàng để chạy lại

Chạy lại việc suy ra sau các lần ghi mới sẽ hợp nhất: chỉ các tuyến mới được thêm vào, còn các yêu cầu hiện có — kể cả những yêu cầu bạn đã chỉnh sửa — vẫn được giữ nguyên.

Trên gói Community, việc ghi và xem các bản ghi hoàn toàn khả dụng; tab Tuyến hiển thị một lời nhắc về tính năng Pro.

Từ một trợ lý AI

Toàn bộ tính năng được cung cấp qua máy chủ MCP của Restorm: tạo và cấu hình một phiên, bắt đầu và dừng ghi, đọc các bản ghi và suy ra các tuyến. Nhờ đó một tác nhân có thể mở một trang, để nó chạy, rồi giao lại một thư mục yêu cầu sẵn sàng sử dụng.