Tóm tắt
Nếu thay đổi gói miễn phí của Postman cắt quyền truy cập vào các bộ sưu tập được chia sẻ của bạn, dữ liệu của bạn không nhất thiết bị mất, nhưng bạn cần hành động nhanh chóng trước khi bộ nhớ đệm cục bộ bị xóa. Hướng dẫn này sẽ chỉ cho bạn mọi cách phục hồi có thể, từ bộ nhớ đệm ứng dụng cục bộ đến các tệp xuất và phục hồi bởi quản trị viên nhóm, đồng thời hướng dẫn cách di chuyển những gì bạn phục hồi được sang Apidog để bạn không rơi vào tình huống này một lần nữa.
Giới thiệu
Những lời phàn nàn nhanh chóng xuất hiện. Sau bản cập nhật gói miễn phí Quý 1 năm 2026 của Postman, các nhà phát triển đã chia sẻ không gian làm việc với đồng nghiệp nhận thấy mình bị khóa quyền truy cập. Không gian làm việc được chia sẻ trở nên không thể truy cập. Các bộ sưu tập nằm trong không gian làm việc của nhóm, chứ không phải của cá nhân, đột nhiên bị đặt sau bức tường phí.
Một nhà phát triển mô tả trên Reddit: “Tôi đến làm việc vào thứ Hai và toàn bộ không gian làm việc của nhóm tôi đã biến mất. Ba tháng với các bộ sưu tập, môi trường được sắp xếp gọn gàng, tất cả đều biến mất. Chỉ còn cách trả tiền thì mới có lại.”
Điều đáng thất vọng là dữ liệu thực sự không bị xóa. Kiến trúc của Postman giữ dữ liệu không gian làm việc ở phía máy chủ, và việc khóa quyền truy cập là một hạn chế quyền truy cập, chứ không phải là xóa. Nhưng sự khác biệt đó chỉ có ý nghĩa nếu bạn biết cách vượt qua nó trước khi bộ nhớ đệm hết hạn hoặc không gian làm việc bị dọn dẹp.
Kiểm tra bộ nhớ đệm của ứng dụng Postman trên máy tính trước tiên
Trước khi làm bất cứ điều gì khác, hãy mở ứng dụng Postman trên máy tính nếu bạn đã cài đặt nó. Đừng mở phiên bản web.
Ứng dụng trên máy tính lưu trữ một bộ nhớ đệm cục bộ của các bộ sưu tập và môi trường bạn truy cập gần đây nhất. Ngay cả khi quyền truy cập phía máy chủ bị thu hồi, bộ nhớ đệm vẫn có thể chứa dữ liệu bộ sưu tập của bạn trong một khoảng thời gian ngắn, thường là vài ngày đến một tuần tùy thuộc vào hệ thống của bạn và cách Postman quản lý việc vô hiệu hóa bộ nhớ đệm.
Các bước kiểm tra:
- Mở Postman trên máy tính (không phải ứng dụng web tại app.getpostman.com).
- Tìm trong tab Lịch sử (History) của bạn để xem các yêu cầu gần đây. Những yêu cầu này không chứa cấu trúc bộ sưu tập đầy đủ, nhưng chúng xác nhận các điểm cuối (endpoints) bạn đang làm việc.
- Kiểm tra xem các bộ sưu tập của bạn có còn xuất hiện ở thanh bên trái không. Nếu có, hãy xuất chúng ngay lập tức.
Để xuất từ thanh bên: nhấp chuột phải hoặc nhấp vào menu ba chấm trên một bộ sưu tập, chọn “Export” (Xuất), và lưu dưới dạng Collection v2.1. Thực hiện thao tác này cho mọi bộ sưu tập bạn vẫn có thể nhìn thấy.
Nếu các bộ sưu tập xuất hiện nhưng bạn nhận được lỗi khi cố gắng xuất, hãy thử làm việc ngoại tuyến. Trong Postman, đi đến góc trên cùng bên phải và nhấp vào ảnh đại diện của bạn, sau đó chọn “Go Offline” (Làm việc ngoại tuyến). Ứng dụng sẽ ngừng cố gắng đồng bộ hóa với máy chủ và có thể cấp cho bạn quyền đọc dữ liệu đã lưu trong bộ nhớ đệm đủ lâu để xuất.
Tìm kiếm các tệp xuất hiện có
Nhiều nhà phát triển định kỳ xuất các bộ sưu tập Postman để sao lưu hoặc chia sẻ với đồng nghiệp. Hãy kiểm tra những vị trí này trước khi cho rằng mọi thứ đã mất.
Thư mục tải xuống của bạn. Tìm kiếm các tệp .json. Các tệp xuất bộ sưu tập Postman sử dụng định dạng JSON với cấu trúc dễ nhận biết chứa một khóa "collection" ở cấp cao nhất.
Kho lưu trữ git của dự án của bạn. Một số nhóm cam kết các tệp JSON bộ sưu tập Postman cùng với cơ sở mã của họ. Kiểm tra lịch sử kho lưu trữ của bạn, bao gồm cả các cam kết cũ hơn, để tìm bất kỳ tệp .json nào trông giống như bộ sưu tập.
Email của bạn. Nếu một đồng nghiệp đã từng chia sẻ một bộ sưu tập với bạn bằng cách xuất và gửi tệp qua email, hãy kiểm tra email của bạn để tìm các tệp đính kèm .json.
Các ổ đĩa được chia sẻ. Kiểm tra Dropbox, Google Drive hoặc bất kỳ thư mục chia sẻ nào mà nhóm của bạn sử dụng. Ai đó có thể đã xuất một bản sao lưu bộ sưu tập mà không nói cho mọi người biết.
Các tệp pipeline CI/CD. Nếu nhóm của bạn đang sử dụng trình chạy Newman CLI của Postman trong một pipeline CI (Jenkins, GitHub Actions, CircleCI), tệp JSON bộ sưu tập có thể đã được đưa vào kho lưu trữ hoặc được lưu trữ dưới dạng artifact của pipeline. Kiểm tra các tệp cấu hình pipeline .yml hoặc .json của bạn để tìm tham chiếu đến các tệp bộ sưu tập.
Liên hệ với chủ sở hữu hoặc quản trị viên không gian làm việc
Nếu bạn là thành viên của không gian làm việc nhóm của người khác, chủ sở hữu không gian làm việc vẫn có thể có quyền truy cập đầy đủ nếu họ là người dùng duy nhất trên tài khoản hoặc nếu họ đã nâng cấp lên gói trả phí.
Liên hệ trực tiếp với chủ sở hữu không gian làm việc và yêu cầu họ:
- Đăng nhập vào tài khoản Postman của họ.
- Điều hướng đến không gian làm việc bạn đã chia sẻ.
- Xuất từng bộ sưu tập qua menu ba chấm.
- Gửi cho bạn các tệp JSON đã xuất.
Nếu tài khoản của chủ sở hữu cũng bị hạ cấp hoặc không thể truy cập, hãy kiểm tra xem có ai trong nhóm của bạn có các bộ sưu tập của không gian làm việc được lưu trong bộ nhớ đệm cục bộ không (sử dụng các bước trong phần trước).
Sử dụng API Postman để lấy dữ liệu của bạn
Nếu bạn vẫn có quyền truy cập API (ngay cả chỉ đọc), API Postman cho phép bạn xuất theo chương trình các bộ sưu tập và môi trường của mình trước khi cửa sổ truy cập của bạn đóng lại.
Bạn cần một khóa API Postman hợp lệ. Nếu bạn vẫn có một khóa từ trước khi thay đổi gói:
GET https://api.getpostman.com/collections
x-api-key: YOUR_POSTMAN_API_KEY
Sau đó lấy từng bộ sưu tập bằng ID:
GET https://api.getpostman.com/collections/{collection_id}
x-api-key: YOUR_POSTMAN_API_KEY
Phần thân phản hồi chứa bộ sưu tập đầy đủ của bạn ở định dạng JSON. Lưu từng bộ sưu tập vào một tệp .json.
Đối với môi trường:
GET https://api.getpostman.com/environments
GET https://api.getpostman.com/environments/{environment_id}
Cách tiếp cận này hoạt động miễn là khóa API của bạn vẫn đang hoạt động. Quyền truy cập khóa API có thể tồn tại trong một thời gian ngắn sau khi quyền truy cập giao diện người dùng bị thu hồi, nhưng đừng trông cậy vào việc nó sẽ kéo dài. Hãy chạy các yêu cầu này càng sớm càng tốt.
Nếu bạn không có khóa API của mình được lưu trữ, hãy kiểm tra các tệp .env của dự án, cấu hình biến môi trường CI/CD hoặc các trình quản lý mật khẩu của bạn.
Tái tạo từ nhật ký mạng trình duyệt hoặc nhật ký máy chủ
Nếu không có tùy chọn nào ở trên hoạt động và bạn thực sự không có tệp xuất hoặc bộ nhớ đệm, bạn có thể tái tạo một phần các bộ sưu tập của mình từ các nguồn khác.
Nhật ký mạng trình duyệt. Nếu bạn đã sử dụng ứng dụng web Postman gần đây, trình duyệt của bạn có thể đã lưu trữ các phản hồi. Trong Chrome, đi tới DevTools (F12), sau đó Ứng dụng (Application) > Bộ nhớ Cache (Cache Storage). Tìm bất kỳ phản hồi API Postman nào được lưu trong bộ nhớ đệm. Điều này khó có thể chứa các bộ sưu tập có cấu trúc đầy đủ, nhưng có thể có chi tiết yêu cầu.
Nhật ký truy cập máy chủ. Nếu nhóm của bạn đã chạy các API mà Postman đang kiểm tra, nhật ký truy cập của máy chủ sẽ hiển thị mọi điểm cuối (endpoint) đã được gọi, với các phương thức, đường dẫn và đôi khi cả tiêu đề. Điều này không cung cấp cho bạn phần thân yêu cầu (request bodies) hoặc các tập lệnh kiểm tra, nhưng nó cung cấp cho bạn cấu trúc điểm cuối để tái tạo tổ chức bộ sưu tập.
Thông số kỹ thuật OpenAPI/Swagger. Nếu API của bạn có thông số kỹ thuật OpenAPI (một tệp swagger.json hoặc openapi.yaml), bạn có thể nhập trực tiếp vào Apidog hoặc một công cụ khác để tạo lại cấu trúc bộ sưu tập với các điểm cuối, tham số và lược đồ phản hồi được tài liệu hóa.
Nhập các bộ sưu tập đã phục hồi của bạn vào Apidog
Khi bạn đã có các tệp JSON bộ sưu tập của mình, việc nhập chúng vào Apidog chỉ mất khoảng hai phút.
- Tải xuống và cài đặt ứng dụng Apidog trên máy tính hoặc mở phiên bản web.
- Tạo một dự án mới.
- Trong dự án, nhấp vào “Import” (Nhập) ở thanh bên trái.
- Chọn “Postman” làm nguồn nhập.
- Tải lên tệp JSON bộ sưu tập của bạn.
- Lặp lại cho mỗi bộ sưu tập.
Đối với môi trường: nhập chúng riêng biệt bằng cách sử dụng quy trình Nhập tương tự, chọn “Postman Environment” làm loại nguồn.
Sau khi nhập, hãy mời đồng đội của bạn. Trên gói miễn phí của Apidog, tối đa 3 người dùng có thể chia sẻ một không gian làm việc. Các bộ sưu tập của bạn sẽ đồng bộ hóa trên tất cả các thành viên trong nhóm mà không phải trả phí cho mỗi người dùng.
Ngăn chặn điều này tái diễn
Vấn đề cốt lõi là Postman đã lưu trữ các bộ sưu tập của bạn ở phía máy chủ và hạn chế quyền truy cập đằng sau việc thanh toán. Bạn có thể tránh hoàn toàn vấn đề này bằng cách chọn các công cụ giữ dữ liệu của bạn cục bộ hoặc cung cấp cho bạn quyền sở hữu xuất rõ ràng.
Apidog lưu trữ các bộ sưu tập cục bộ theo mặc định. Đồng bộ hóa đám mây là tùy chọn, không bắt buộc. Nếu có bất kỳ thay đổi về giá nào xảy ra, dữ liệu của bạn đã có sẵn trên máy của bạn.
Bất kể bạn sử dụng công cụ nào trong tương lai, hãy tạo thói quen xuất định kỳ:
- Xuất các bộ sưu tập của bạn dưới dạng JSON vào cuối mỗi sprint.
- Cam kết các tệp JSON bộ sưu tập vào kho lưu trữ git của bạn cùng với cơ sở mã của bạn.
- Lưu trữ các tệp môi trường (đã loại bỏ các bí mật) trong tài liệu phát triển của kho lưu trữ của bạn.
Những thói quen này chỉ mất năm phút để thiết lập và loại bỏ hoàn toàn kịch bản “bị khóa quyền truy cập”.
Mất quyền truy cập vào các công cụ bạn phụ thuộc mà không có cảnh báo là một trải nghiệm khó chịu, và sự thay đổi gói miễn phí của Postman đã khiến nhiều nhóm bị bất ngờ. Tin tốt là hầu hết dữ liệu đều có thể phục hồi nếu bạn hành động nhanh chóng và thực hiện các tùy chọn theo thứ tự. Khi bạn đã lấy lại được các bộ sưu tập đã xuất của mình, việc chuyển sang một công cụ giữ dữ liệu của bạn cục bộ sẽ giúp bạn ở một vị thế tốt hơn nhiều về lâu dài.