Cara Berbagi Koleksi Postman Tanpa Upgrade Paket Tim

Intinya

Paket gratis Postman membatasi berbagi koleksi dengan cara yang mengejutkan banyak pengembang. Jika Anda perlu berkolaborasi dengan rekan tim tanpa membayar $19/pengguna/bulan, ada beberapa solusi, tetapi masing-masing memiliki konsekuensi yang nyata. Paket gratis Apidog memungkinkan Anda berbagi ruang kerja dengan hingga 3 pengguna, tanpa perlu peningkatan.

Pendahuluan

Postman dimulai sebagai ekstensi Chrome sederhana untuk mengirim permintaan HTTP. Selama bertahun-tahun, ia berkembang menjadi platform API yang lengkap, dan harganya pun ikut meningkat. Saat ini, tim yang ingin berbagi koleksi dan berkolaborasi secara real-time memerlukan paket berbayar. Paket gratisnya membuat banyak pengembang mencari solusi.

Jika Anda menjalankan tim kecil, proyek sampingan, atau startup di mana setiap dolar berarti, membayar $19 per pengguna per bulan hanya untuk berbagi koleksi terasa sangat banyak. Itu $228 per orang per tahun sebelum Anda meluncurkan satu fitur pun.

Kabar baiknya adalah ada cara-cara yang sah untuk berbagi koleksi Postman pada paket gratis. Tidak ada yang semudah membayar paket Tim, tetapi cara-cara ini berfungsi. Panduan ini membahas setiap metode, menjelaskan kekurangannya, dan menunjukkan kepada Anda seperti apa alternatif gratis yang sebenarnya.

Apa yang sebenarnya diizinkan oleh paket gratis Postman

Sebelum melihat solusi, ada baiknya memahami apa saja yang termasuk dalam paket gratis per 2024-2025.

Paket gratis Postman memberikan Anda:

• 1 pengguna per ruang kerja (tidak ada pengeditan bersama)
• Hingga 3 ruang kerja publik aktif
• Ruang kerja pribadi tanpa batas
• 1.000 panggilan server mock per bulan
• 1.000 panggilan pemantauan per bulan
• Eksekusi koleksi terbatas hingga 25 per bulan di cloud runner

Batasan krusial: Anda tidak dapat mengundang rekan tim ke ruang kerja pribadi di paket gratis. Ruang kerja pribadi memerlukan setidaknya paket Basic seharga $19/pengguna/bulan. Itulah kendala pertama yang dihadapi sebagian besar tim kecil.

Metode 1: Ekspor koleksi sebagai JSON dan bagikan file-nya

Solusi paling langsung adalah mengekspor koleksi Anda sebagai file JSON dan mengirimkannya ke rekan tim Anda.

Cara melakukannya:

1. Buka Postman dan navigasikan ke koleksi Anda di bilah sisi kiri.
2. Klik menu tiga titik di samping nama koleksi.
3. Pilih "Ekspor".
4. Pilih format Koleksi v2.1 (ini adalah standar saat ini dan memiliki kompatibilitas terluas).
5. Simpan file JSON dan bagikan melalui email, Slack, atau drive bersama.

Rekan tim Anda mengimpornya dengan masuk ke File > Import dan menyeret file JSON tersebut.

Apa kekurangannya:

• Saat Anda mengekspor, koleksi tersebut menjadi snapshot. Jika Anda menambahkan endpoint baru atau memperbaiki permintaan, rekan tim Anda tidak akan tahu. Mereka bekerja dari salinan yang sudah usang.
• Variabel lingkungan tidak ikut serta dalam koleksi secara default. Anda perlu mengekspor lingkungan secara terpisah, dan rekan tim Anda juga harus mengimpornya. Jika Anda melupakan satu variabel, permintaan mereka akan gagal dan mereka akan menghabiskan waktu men-debug sesuatu yang sebenarnya tidak rusak.
• Tidak ada alur kerja penggabungan (merge). Jika dua orang mengedit salinan lokal mereka secara bersamaan dan kemudian mencoba merekonsiliasinya, Anda harus melakukannya secara manual.

Metode ini berfungsi untuk penyerahan satu kali yang sesekali. Ini akan cepat rusak jika koleksi sering berubah.

Metode 2: Gunakan ruang kerja publik

Postman memungkinkan Anda membuat ruang kerja publik di paket gratis. Siapa pun yang memiliki tautan dapat melihat dan mem-fork koleksi tersebut.

Cara mengaturnya:

1. Buat ruang kerja baru di Postman.
2. Saat diminta untuk memilih visibilitas, pilih "Publik".
3. Tambahkan koleksi Anda ke ruang kerja publik.
4. Bagikan URL ruang kerja kepada rekan tim Anda.

Rekan tim Anda dapat mem-fork koleksi ke ruang kerja mereka sendiri dan bekerja dari sana.

Apa kekurangannya:

• Publik berarti publik. Siapa pun di internet dapat menemukan dan melihat koleksi Anda jika mereka memiliki URL atau mencari di jaringan API publik Postman. Untuk alat internal, lingkungan staging, atau apa pun dengan token autentikasi yang tercakup dalam contoh respons, ini adalah risiko yang signifikan.
• Koleksi yang di-fork tidak sinkron secara otomatis. Jika Anda memperbarui yang asli, rekan tim perlu menarik perubahan secara manual ke fork mereka. Tidak ada pemberitahuan bahwa perubahan telah terjadi.
• Komentar dan kolaborasi langsung masih memerlukan paket Tim. Ruang kerja publik bersifat hanya-baca bagi pengunjung; mereka tidak dapat mengedit yang asli.

Metode ini berfungsi dengan baik untuk proyek open-source atau dokumentasi API publik. Ini tidak cocok untuk alur kerja tim internal.

Metode 3: Gunakan repositori Git sebagai lapisan sinkronisasi

Beberapa tim memecahkan masalah sinkronisasi dengan memperlakukan JSON yang diekspor sebagai artefak kode dan meng-commit-nya ke repositori Git.

Alur kerjanya seperti ini:

1. Satu orang memiliki koleksi Postman dan mengekspornya setelah setiap perubahan yang signifikan.
2. Mereka meng-commit JSON yang diperbarui ke repo Git bersama (GitHub, GitLab, Bitbucket).
3. Rekan tim menarik versi terbaru dan mengimpornya ke Postman lokal mereka.

Apa kekurangannya:

• Setiap impor menimpa koleksi lokal yang sudah ada. Jika rekan tim membuat perubahan lokal, perubahan tersebut akan hilang kecuali mereka mengekspor dan menggabungkan terlebih dahulu.
• Alur kerja ini membutuhkan disiplin. Seseorang harus ingat untuk mengekspor dan meng-commit setiap kali ada perubahan. Dalam praktiknya, versi Git hampir selalu tertinggal dari keadaan Postman yang sebenarnya.
• Anda tidak dapat menjalankan permintaan langsung dari repo Git. Seseorang harus selalu melakukan langkah impor, yang memakan waktu dan menimbulkan gesekan.

Metode ini lebih baik daripada berbagi file mentah karena memberikan Anda riwayat dan satu sumber kebenaran, tetapi langkah-langkah manual menambahkan beban kerja yang memperlambat tim.

Metode 4: Gunakan ruang kerja pribadi gratis Postman dengan satu akun "utama"

Beberapa tim kecil mengatasi batasan kolaborasi dengan meminta semua orang berbagi satu akun Postman. Satu orang masuk di beberapa mesin menggunakan kredensial yang sama.

Ini melanggar Ketentuan Layanan Postman dan menimbulkan masalah nyata:

• Postman dapat mendeteksi kredensial bersama dan mengunci akun.
• Perubahan yang dilakukan oleh satu orang dapat menimpa perubahan yang dilakukan oleh orang lain jika terjadi konflik sinkronisasi.
• Tidak ada cara untuk mengaitkan perubahan dengan orang tertentu.

Metode ini disebutkan di sini karena tim memang menggunakannya, bukan karena itu ide yang bagus.

Bagaimana Apidog menangani berbagi di paket gratis

Apidog mengambil pendekatan berbeda terhadap masalah kolaborasi. Paket gratisnya mencakup hingga 3 anggota tim dalam ruang kerja bersama, dengan sinkronisasi real-time di antara semuanya. Tidak ada solusi, tidak ada pengacakan file JSON.

Ketika Anda membuat perubahan pada definisi API di Apidog, rekan tim Anda akan segera melihatnya. Anda semua bekerja dari sumber kebenaran yang sama tanpa ada yang perlu mengekspor atau mengimpor apa pun.

Jika Anda sudah menggunakan Postman, Anda dapat mengimpor koleksi yang sudah ada secara langsung. Apidog membaca format Koleksi Postman v2.1, jadi peralihannya hanya sekali klik, bukan proyek akhir pekan.

Paket gratis juga mencakup:

• Editor desain API lengkap (OpenAPI 3.0 dan Swagger)
• Smart Mock untuk menghasilkan respons realistis tanpa ketergantungan cloud
• Test runner tanpa batasan eksekusi bulanan
• Dokumentasi API yang dibuat secara otomatis dari definisi Anda
• Penyimpanan lokal-pertama, sehingga data Anda tetap di mesin Anda kecuali Anda memilih untuk menyinkronkan

Untuk tim beranggotakan 2-3 orang, paket gratis Apidog mencakup hal yang sama dengan paket Tim Postman, tanpa biaya.Memilih metode yang tepat untuk situasi Anda

Berikut panduan keputusan singkat:

Jika tim Anda secara aktif membangun API dan Anda mencapai batasan berbagi Postman, solusi JSON dan Git akan memperlambat Anda. Mereka menyelesaikan masalah langsung tetapi menambahkan gesekan berkelanjutan.

Pertanyaan Umum

Bisakah saya berbagi koleksi Postman tanpa akun?Ya. Ekspor koleksi sebagai file JSON dan kirim file tersebut secara langsung. Penerima dapat mengimpornya tanpa akun Postman jika mereka menggunakan klien API yang mendukung format Postman Collection v2.1, termasuk Apidog.

Apakah paket Basic Postman memungkinkan berbagi tim?Ya. Paket Basic seharga $19/pengguna/bulan memungkinkan kolaborasi ruang kerja pribadi dengan banyak pengguna. Paket gratis tidak.

Apa itu ruang kerja publik Postman?Ruang kerja publik terlihat oleh siapa pun di internet. Pengunjung dapat melihat dan mem-fork koleksi tetapi tidak dapat mengedit yang asli. Gratis untuk membuat hingga 3 ruang kerja publik di paket gratis.

Apakah variabel lingkungan saya akan diekspor bersama dengan koleksi saya?Tidak. Variabel lingkungan diekspor secara terpisah. Buka Lingkungan (Environments) di bilah sisi, klik menu tiga titik pada lingkungan yang Anda butuhkan, dan ekspor sebagai file JSON terpisah. Bagikan kedua file tersebut kepada rekan tim Anda.

Berapa banyak pengguna yang dapat berbagi ruang kerja di paket gratis Apidog?Paket gratis Apidog mendukung hingga 3 pengguna dalam ruang kerja bersama dengan sinkronisasi real-time, tanpa memerlukan kartu kredit.

Bisakah saya mengimpor koleksi Postman yang sudah ada ke Apidog?Ya. Apidog mendukung impor langsung file JSON Postman Collection v2.1. Buka Impor di Apidog, pilih file Anda, dan koleksi Anda akan masuk dengan permintaan, header, dan variabel lingkungan yang utuh.

Batasan berbagi pada paket gratis Postman adalah nyata, dan solusi yang ada memiliki biaya nyata dalam hal waktu dan keandalan. Untuk tim beranggotakan hingga 3 orang yang membutuhkan kolaborasi nyata, beralih ke alat yang dirancang untuk berbagi di paket gratis seringkali lebih bersih daripada menambal alur kerja yang membutuhkan upaya manual terus-menerus.