Chuyển từ Postman
1. Xuất ra từ Postman
Section titled “1. Xuất ra từ Postman”Trong Postman: Collection ▸ … ▸ Export ▸ Collection v2.1. Hãy làm tương tự với các môi trường của bạn.
2. Nhập vào Restorm
Section titled “2. Nhập vào Restorm”Tệp ▸ Nhập (Ctrl+I) rồi chọn tệp JSON. Restorm tự phát hiện định dạng.
Chi tiết: Nhập một bộ sưu tập Postman.
Cái gì tự động chuyển được
Section titled “Cái gì tự động chuyển được”| Postman | Restorm |
|---|---|
| Thư mục | Thư mục, ở cùng độ sâu |
| Yêu cầu HTTP | Yêu cầu HTTP |
| Yêu cầu GraphQL | Yêu cầu GraphQL (không phải yêu cầu HTTP) |
| Thân raw, formdata, urlencoded, file, graphql | Kiểu thân tương ứng |
| Biến của bộ sưu tập | Biến của một môi trường |
| Mô tả | Ghi chú và tài liệu API |
| Phản hồi ví dụ | Tài liệu API |
| Script tiền yêu cầu và kiểm thử | Một kịch bản thực thi được, với lớp pm.* |
Cái gì cần điều chỉnh
Section titled “Cái gì cần điều chỉnh”Phần xác thực
Section titled “Phần xác thực”Các khối xác thực của Postman được ghi thành tài liệu (với giá trị nhạy cảm đã bị che) nhưng không được chuyển thành thông tin đăng nhập thực thi được.
Hãy tạo lại một yêu cầu xác thực: chỉ mất
năm phút, và bạn được thêm cơ chế tự động gia hạn token cùng việc thử lại khi
gặp 401, những thứ mà Postman không tự làm.
Các môi trường
Section titled “Các môi trường”Hãy xuất chúng ra từ Postman rồi tạo lại trong một thư mục biến.
Nhân dịp này hãy dùng luôn các môi trường con: chỗ mà Postman áp đặt một môi trường phẳng cho mỗi đích, thì Restorm cho phép một nền chung cùng các phép ghi đè theo từng khách hàng hay từng khu vực.
Các runner và Newman
Section titled “Các runner và Newman”Đây là phần thay thế đáng giá nhất. Một kịch bản làm được những gì một runner làm, mà còn tốt hơn:
- luồng chạy nhìn thấy được thay vì là một thứ tự bộ sưu tập ngầm định;
- các nhánh, vòng lặp và lần thử lại đều là những chiếc hộp, chứ không phải
pm.setNextRequest; - việc chạy trong CI đã được tích hợp, với các mã thoát gọn gàng — xem Chạy headless và CI.
Các khái niệm tương đương
Section titled “Các khái niệm tương đương”| Postman | Restorm |
|---|---|
| Workspace | Một dự án .restorm, quản lý phiên bản trong git |
| Collection | Một thư mục hoặc một thư mục biến |
| Environment | Một môi trường trong một thư mục biến |
| Globals | Một môi trường gốc, được các môi trường con kế thừa |
| Pre-request / Test script | Một kịch bản, hoặc một hành động mã |
| Collection Runner | Một kịch bản |
| Newman | restorm --run --headless |
| Mock Server | Chế độ máy chủ, chạy tại chỗ |
| Monitors | Một hành động Bộ hẹn giờ, hoặc một tác vụ định kỳ của hệ thống CI của bạn |
| Postman Console | Bảng điều khiển |
Biến động {{$random…}} | Vẫn những biến đó, cộng thêm 116 helper — xem tham chiếu |
Khác biệt cốt lõi
Section titled “Khác biệt cốt lõi”Các yêu cầu của bạn trở thành những tệp trong kho mã của bạn. Chúng đi theo cùng một chu trình duyệt như mã của bạn, lịch sử của chúng chính là lịch sử git, và quyền truy cập là quyền của nền tảng lưu trữ mã của bạn.
Không có không gian làm việc lưu trữ trên đám mây phải quản trị, và không có dữ
liệu API nào nằm trên một dịch vụ bên thứ ba. Xem
Dự án và tệp .restorm.
Và những gì Postman có mà Restorm không có
Section titled “Và những gì Postman có mà Restorm không có”Để nói cho thật lòng: Restorm không có không gian làm việc cộng tác lưu trữ trên đám mây, không có cổng API công khai, không có bình luận trực tiếp trên các yêu cầu, và không có dịch vụ giám sát lưu trữ sẵn. Nếu tổ chức của bạn dựa vào những thứ đó, chúng không có thứ tương đương trực tiếp — việc chia sẻ đi qua git.