TL;DR
Jika perubahan paket gratis Postman memutus akses Anda ke koleksi yang dibagikan, data Anda belum tentu hilang, tetapi Anda perlu bertindak cepat sebelum cache lokal terhapus. Panduan ini menjelaskan setiap jalur pemulihan yang tersedia, mulai dari cache aplikasi lokal hingga file ekspor hingga pemulihan admin tim, dan menunjukkan cara memigrasikan apa yang Anda pulihkan ke Apidog agar Anda tidak berada dalam posisi ini lagi.
Pendahuluan
Keluhan-keluhan itu muncul dengan cepat. Setelah pembaruan tingkat gratis Postman pada Q1 2026, para pengembang yang telah berbagi ruang kerja dengan rekan-rekan mereka menemukan diri mereka terkunci. Ruang kerja bersama menjadi tidak dapat diakses. Koleksi yang berada di ruang kerja tim, bukan pribadi, tiba-tiba berada di balik batasan pembayaran.
Seorang pengembang menggambarkannya di Reddit: “Saya masuk pada hari Senin dan seluruh ruang kerja tim saya hilang. Tiga bulan koleksi terorganisir, lingkungan, semuanya. Hilang begitu saja kecuali kami membayar.”
Bagian yang membuat frustrasi adalah bahwa data tersebut sebenarnya tidak dihapus. Arsitektur Postman menyimpan data ruang kerja di sisi server, dan penguncian adalah pembatasan akses, bukan penghapusan. Namun perbedaan itu hanya penting jika Anda tahu cara mengatasinya sebelum cache kedaluwarsa atau ruang kerja dibersihkan.
Periksa cache aplikasi desktop Postman Anda terlebih dahulu
Sebelum melakukan hal lain, buka aplikasi desktop Postman jika Anda menginstalnya. Jangan buka versi web.
Aplikasi desktop menyimpan cache lokal dari koleksi dan lingkungan yang paling baru Anda akses. Meskipun akses sisi server dicabut, cache mungkin masih berisi data koleksi Anda untuk jangka waktu singkat, biasanya beberapa hari hingga seminggu tergantung pada sistem Anda dan bagaimana Postman mengelola invalidasi cache.
Langkah-langkah untuk memeriksa:
- Buka aplikasi desktop Postman (bukan aplikasi web di app.getpostman.com).
- Cari di tab Riwayat Anda untuk permintaan terbaru. Ini tidak berisi struktur koleksi lengkap, tetapi mereka mengonfirmasi titik akhir apa yang sedang Anda kerjakan.
- Periksa apakah koleksi Anda masih muncul di bilah sisi kiri. Jika ya, ekspor segera.
Untuk mengekspor dari bilah sisi: klik kanan atau klik menu tiga titik pada koleksi, pilih "Ekspor," dan simpan sebagai Koleksi v2.1. Lakukan ini untuk setiap koleksi yang masih bisa Anda lihat.
Jika koleksi muncul tetapi Anda mendapatkan kesalahan saat mencoba mengekspor, coba bekerja secara offline. Di Postman, buka kanan atas dan klik avatar Anda, lalu "Go Offline." Aplikasi akan berhenti mencoba menyinkronkan dengan server dan mungkin memberi Anda akses baca ke data yang di-cache cukup lama untuk diekspor.
Cari file ekspor yang ada
Banyak pengembang mengekspor koleksi Postman secara berkala untuk cadangan atau untuk dibagikan dengan rekan kerja. Periksa lokasi-lokasi ini sebelum berasumsi semuanya hilang.
Folder unduhan Anda. Cari file .json. Ekspor koleksi Postman menggunakan format JSON dengan struktur yang dapat dikenali yang berisi kunci "collection" di tingkat atas.
Repositori git proyek Anda. Beberapa tim melakukan commit file JSON koleksi Postman bersama kode dasar mereka. Periksa riwayat repo Anda, termasuk commit lama, untuk file .json apa pun yang terlihat seperti koleksi.
Email Anda. Jika seorang rekan pernah berbagi koleksi dengan Anda dengan mengekspor dan mengirimkan file tersebut melalui email, periksa email Anda untuk lampiran .json.
Drive bersama. Periksa Dropbox, Google Drive, atau folder bersama apa pun yang digunakan tim Anda. Seseorang mungkin telah mengekspor cadangan koleksi tanpa memberitahu semua orang.
File pipeline CI/CD. Jika tim Anda menggunakan runner CLI Newman Postman dalam pipeline CI (Jenkins, GitHub Actions, CircleCI), JSON koleksi kemungkinan telah di-check-in ke repo atau disimpan sebagai artefak pipeline. Periksa file konfigurasi pipeline .yml atau .json Anda untuk referensi ke file koleksi.
Hubungi pemilik atau admin ruang kerja
Jika Anda adalah anggota dari ruang kerja tim orang lain, pemilik ruang kerja mungkin masih memiliki akses penuh jika mereka adalah satu-satunya pengguna di akun tersebut atau jika mereka meningkatkan ke paket berbayar.
Hubungi pemilik ruang kerja secara langsung dan minta mereka untuk:
- Masuk ke akun Postman mereka.
- Navigasi ke ruang kerja yang Anda bagikan.
- Ekspor setiap koleksi melalui menu tiga titik.
- Kirimkan file JSON yang diekspor kepada Anda.
Jika akun pemilik juga diturunkan atau tidak dapat diakses, periksa apakah ada orang di tim Anda yang memiliki koleksi ruang kerja yang di-cache secara lokal (menggunakan langkah-langkah di bagian sebelumnya).
Gunakan API Postman untuk menarik data Anda
Jika Anda masih memiliki akses API (bahkan hanya baca), API Postman memungkinkan Anda mengekspor koleksi dan lingkungan Anda secara terprogram sebelum jendela akses Anda tertutup.
Anda memerlukan kunci API Postman yang valid. Jika Anda masih memilikinya dari sebelum perubahan paket:
Dapatkan daftar koleksi Anda:
GET https://api.getpostman.com/collections
x-api-key: KUNCI_API_POSTMAN_ANDA
Kemudian ambil setiap koleksi berdasarkan ID:
GET https://api.getpostman.com/collections/{id_koleksi}
x-api-key: KUNCI_API_POSTMAN_ANDA
Isi respons berisi koleksi lengkap Anda dalam format JSON. Simpan setiap koleksi ke file .json.
Untuk lingkungan:
GET https://api.getpostman.com/environments
GET https://api.getpostman.com/environments/{id_lingkungan}
Pendekatan ini berfungsi selama kunci API Anda masih aktif. Akses kunci API mungkin bertahan sebentar setelah akses UI dicabut, tetapi jangan berharap itu akan bertahan lama. Jalankan permintaan ini sesegera mungkin.
Jika Anda tidak menyimpan kunci API Anda, periksa file .env proyek Anda, konfigurasi variabel lingkungan CI/CD, atau pengelola kata sandi.
Rekonstruksi dari log jaringan browser atau log server
Jika tidak ada opsi di atas yang berhasil dan Anda benar-benar tidak memiliki ekspor atau cache, Anda mungkin dapat merekonstruksi sebagian koleksi Anda dari sumber lain.
Log jaringan browser. Jika Anda menggunakan aplikasi web Postman baru-baru ini, browser Anda mungkin telah menyimpan respons yang di-cache. Di Chrome, buka DevTools (F12), lalu Application > Cache Storage. Cari respons API Postman yang di-cache. Ini tidak mungkin berisi koleksi terstruktur lengkap, tetapi mungkin memiliki detail permintaan.
Log akses server. Jika tim Anda menjalankan API yang diuji Postman, log akses server Anda akan menampilkan setiap titik akhir yang dipanggil, dengan metode, jalur, dan terkadang header. Ini tidak memberi Anda isi permintaan atau skrip pengujian, tetapi ini memberi Anda struktur titik akhir untuk merekonstruksi organisasi koleksi.
Spesifikasi OpenAPI/Swagger. Jika API Anda memiliki spesifikasi OpenAPI (file swagger.json atau openapi.yaml), Anda dapat mengimpornya langsung ke Apidog atau alat lain untuk membuat ulang struktur koleksi dengan titik akhir, parameter, dan skema respons yang didokumentasikan.
Impor koleksi Anda yang dipulihkan ke Apidog
Setelah Anda memiliki file JSON koleksi Anda, mengimpornya ke Apidog hanya membutuhkan waktu sekitar dua menit.
- Unduh dan instal aplikasi desktop Apidog atau buka versi web.
- Buat proyek baru.
- Di proyek, klik "Impor" di bilah sisi kiri.
- Pilih "Postman" sebagai sumber impor.
- Unggah file JSON koleksi Anda.
- Ulangi untuk setiap koleksi.
Untuk lingkungan: impor secara terpisah menggunakan alur Impor yang sama, pilih "Postman Environment" sebagai jenis sumber.
Setelah diimpor, undang rekan tim Anda. Pada paket gratis Apidog, hingga 3 pengguna dapat berbagi ruang kerja. Koleksi Anda disinkronkan di antara semua anggota tim tanpa biaya per pengguna.
Cegah agar ini tidak terjadi lagi
Masalah intinya adalah Postman menyimpan koleksi Anda di sisi server dan membatasi akses di balik penagihan. Anda dapat menghindari masalah ini sepenuhnya dengan memilih alat yang menyimpan data Anda secara lokal atau memberi Anda kepemilikan ekspor yang jelas.
Apidog menyimpan koleksi secara lokal secara default. Sinkronisasi cloud bersifat opsional, bukan wajib. Jika ada perubahan harga, data Anda sudah ada di mesin Anda.
Terlepas dari alat apa yang Anda gunakan selanjutnya, bangun kebiasaan ekspor rutin:
- Ekspor koleksi Anda sebagai JSON di akhir setiap sprint.
- Commit file JSON koleksi ke repo git Anda bersama kode dasar Anda.
- Simpan file lingkungan (dengan rahasia yang dihilangkan) di dokumentasi dev repo Anda.
Kebiasaan ini membutuhkan waktu lima menit untuk disiapkan dan menghilangkan skenario "terkunci" sepenuhnya.
Kehilangan akses ke alat yang Anda andalkan tanpa peringatan adalah pengalaman yang membuat frustrasi, dan perubahan tingkat gratis Postman mengejutkan banyak tim. Kabar baiknya adalah sebagian besar data dapat dipulihkan jika Anda bergerak cepat dan mengerjakan opsi-opsi secara berurutan. Setelah Anda kembali pulih dengan koleksi Anda diekspor, migrasi ke alat yang menyimpan data Anda secara lokal menempatkan Anda pada posisi yang jauh lebih baik untuk jangka panjang.