Pindah dari Postman ke Bruno: skrip dan variabel perlu diperiksa ulang

Untuk memindahkan koleksi API dari Postman ke Bruno, ekspor koleksi sebagai JSON, impor berkasnya ke Bruno, lalu pindahkan environment yang diperlukan secara terpisah. Setelah itu, cocokkan skrip, variabel, dan autentikasi dengan koleksi asal. Daftar permintaan yang sudah muncul di Bruno belum menunjukkan bahwa rangkaian permintaan akan berjalan dengan hasil yang sama.

Siapkan pembanding sebelum ekspor: environment aktif, permintaan penting, nilai yang dihasilkan oleh skrip, serta kredensial yang dipakai antarpermintaan. Pemeriksaan setelah impor perlu mencakup perilaku permintaan dan pengujian respons, bukan hanya nama folder atau jumlah permintaan. Pisahkan nilai rahasia sebelum berkas koleksi mulai dibagikan melalui Git.

Catat konfigurasi yang harus ikut berpindah

Inventaris awal membantu menemukan selisih yang sulit terlihat dari daftar permintaan. Catat koleksi dan environment yang dipakai, permintaan yang bergantung pada urutan eksekusi, skrip sebelum pengiriman, dan pengujian setelah respons diterima. Tandai pengaturan autentikasi pada koleksi, folder, atau permintaan agar cakupannya dapat diperiksa lagi di Bruno.

Untuk variabel penting, tulis nama, cakupan, fungsi, dan apakah nilainya sensitif. Dalam contoh hipotetis, base_url dapat menjadi konfigurasi bersama, sedangkan token akses harus disediakan lewat mekanisme rahasia yang dipilih tim. Periksa juga variabel global yang dipakai skrip: berkas koleksi dan berkas environment saja mungkin belum mewakili semua nilai yang tersedia dalam alur kerja Postman.

Simpan salinan ekspor asal sebagai pembanding selama migrasi berlangsung. Jika permintaan hasil impor mengirim header atau body yang berbeda, Anda dapat menelusuri apakah selisihnya berasal dari berkas sumber, pilihan environment, atau perubahan yang dibuat setelah impor. Catatan singkat tentang permintaan prioritas akan lebih berguna daripada mencoba menguji seluruh koleksi tanpa urutan.

Ekspor JSON, lalu impor koleksi dan environment

Buka menu koleksi di Postman dan ekspor berkas JSON. Jika dialog menyediakan pilihan format, pilih Collection v2.1; petunjuk ekspor Postman versi 11 mencantumkan pilihan Collection v2 atau v2.1 serta langkah terpisah untuk mengekspor environment dan variabel global. Ekspor setiap environment yang benar-benar digunakan oleh koleksi, bukan hanya environment yang kebetulan sedang terbuka.

Di Bruno, pilih Import Collection dari layar awal atau menu tambah, pilih JSON koleksi Postman, lalu tentukan lokasi penyimpanan. Sesudah koleksi muncul, buka konfigurasi Environments dan impor berkas JSON environment satu per satu. Pilih environment yang sesuai sebelum menjalankan permintaan; dua environment dengan nama serupa bisa mengarah ke server atau kredensial yang berbeda.

Periksa hasil impor pada tingkat folder dan permintaan: metode, URL, parameter, header, body, serta pengaturan autentikasi. Jika ada nama environment yang sama dengan yang sudah ada di koleksi Bruno, perhatikan pilihan untuk mengganti, membuat salinan baru, atau melewatinya. Jangan merapikan struktur lebih dulu; membandingkan hasil impor yang masih utuh dengan sumbernya membuat perubahan lebih mudah dilacak.

Cocokkan perilaku skrip, variabel, dan autentikasi

Panduan migrasi Bruno menjelaskan bahwa impor menerjemahkan API skrip Postman yang umum, mengubah nilai environment nonteks menjadi string, dan menandai paket eksternal yang perlu diperhatikan. Paket khusus Postman yang tidak memiliki padanan di Bruno dapat membuat skrip gagal saat dijalankan. Karena itu, bandingkan tujuan setiap skrip dengan hasilnya, terutama skrip yang menyiapkan token atau menyimpan nilai untuk permintaan berikutnya.

Periksa variabel berdasarkan nama dan cakupan pemakaiannya. Nilai angka, boolean, atau objek yang menjadi string dapat mengubah hasil perbandingan dalam skrip atau isi body yang disusun secara dinamis. Bila logika memang memerlukan tipe tertentu, sesuaikan skrip yang memakainya dan uji keluarannya; mengganti seluruh nilai secara massal dapat menyembunyikan perbedaan perilaku.

Untuk skrip yang memakai paket, bedakan paket npm yang dapat dipasang, pustaka yang memerlukan Developer Mode, dan paket khusus Postman yang perlu ditulis ulang. Aktifkan Developer Mode hanya untuk koleksi yang dipercaya karena mode itu memberi skrip akses lebih luas ke sistem. Bruno juga menyediakan opsi Preserve scripts saat impor untuk mempertahankan skrip pm.* apa adanya; pilihan tersebut tetap perlu diuji terhadap perilaku permintaan yang diharapkan.

Uji autentikasi pada endpoint yang memang dilindungi. Cocokkan jenis autentikasi, lokasi kredensial pada header atau parameter, dan apakah pengaturan diwariskan dari koleksi atau folder. Jika satu permintaan memperoleh token bagi permintaan lain, jalankan keduanya dalam urutan tersebut dan pastikan token dibaca dari variabel yang tepat. Keberhasilan permintaan publik tidak menjawab apakah alur autentikasi ikut berpindah.

Jauhkan nilai rahasia dari berkas yang akan dibagikan

Sebelum commit, cari token, kata sandi, API key, cookie, dan URL yang memuat kredensial di seluruh berkas hasil impor, termasuk environment dan skrip. Nama variabel dapat dibagikan agar konfigurasi mudah dipahami, tetapi nilainya perlu disediakan secara terpisah oleh tiap pengembang atau sistem otomatis. Berkas ekspor Postman yang masih disimpan sebagai pembanding juga perlu diperlakukan sebagai berkas sensitif bila memuat nilai tersebut.

Tim dapat menyiapkan contoh environment yang berisi nama variabel tanpa nilai rahasia, lalu menyimpan nilai sebenarnya melalui mekanisme lokal atau pengelola rahasia yang dipakai bersama. Jika menggunakan berkas lokal untuk kredensial, masukkan berkas itu ke aturan pengabaian Git dan periksa daftar perubahan yang akan di-commit. Aturan pengabaian tidak menghapus nilai yang sudah masuk ke berkas terlacak; kredensial yang telanjur masuk riwayat Git harus dirotasi sesuai prosedur layanan terkait.

Pindahkan kerja bersama ke Git dan tinjau diff awal

Koleksi Bruno dapat disimpan sebagai berkas dalam repositori, sehingga perubahan permintaan dan skrip dapat ditinjau melalui diff. Menurut dokumentasi kolaborasi Bruno, tim dapat memakai perintah Git atau antarmuka Git di aplikasi; fitur antarmuka untuk commit, push, percabangan, dan penyelesaian konflik memerlukan edisi Pro atau Ultimate. Pilih repositori bersama kode API atau repositori khusus sesuai alur review tim.

Pada diff pertama, pastikan berkas permintaan dan environment yang diharapkan tercatat, sementara nilai rahasia tidak muncul. Diff impor awal bisa besar karena koleksi berubah bentuk menjadi berkas Bruno; gunakan inventaris awal untuk menilai isinya, bukan ukuran diff saja. Setelah keadaan awal disetujui, perubahan pada skrip, variabel, atau permintaan berikutnya akan lebih mudah ditinjau dalam perubahan Git yang terpisah.

Jalankan ulang permintaan yang menentukan hasil migrasi

Mulailah dengan permintaan yang memeriksa URL dasar, lalu jalankan permintaan autentikasi dan permintaan yang memakai kredensial hasilnya. Sertakan permintaan yang menggunakan variabel hasil skrip dan pengujian respons yang penting bagi tim. Untuk operasi yang mengubah data, gunakan environment serta data uji yang aman agar pemeriksaan tidak menyentuh data produksi tanpa sengaja.

Bandingkan metode, URL akhir, header, body, status respons, dan hasil pengujian skrip dengan perilaku yang diharapkan dari koleksi asal. Catat selisih bersama penyebabnya: environment yang salah, variabel dengan tipe berbeda, autentikasi yang tidak diwariskan, atau skrip yang belum bekerja. Permintaan yang mendapat respons berhasil tetapi melewatkan pengujian penting masih memerlukan perbaikan sebelum koleksi dijadikan acuan bersama.

Baca juga:

• Jangan mulai dari alat—pilih satu alur kerja AI yang bisa diperiksa
• Panggilan pertama Claude API: pisahkan kunci, workspace, dan batas biaya sejak awal
• Ekspor Google Takeout bukan menghapus data—arsipnya justru perlu diamankan