Pembatasan Postman Collection Runner: Apa yang Berubah dan Solusinya

TL;DR

Postman membatasi akses Collection Runner pada tingkatan gratisnya, sehingga mengganggu eksekusi pengujian otomatis untuk tim yang belum meningkatkan langganan. Ini memengaruhi jalankan pengujian lokal, pipeline CI/CD, dan setiap alur kerja yang menggunakan Runner untuk eksekusi permintaan secara massal. Artikel ini menjelaskan apa yang berubah, apa yang rusak dalam praktiknya, dan bagaimana runner Apidog berfungsi tanpa batasan pada tingkatan mana pun.

Pendahuluan

Collection Runner Postman adalah salah satu fitur yang paling banyak digunakan. Anda akan membuat koleksi 50 permintaan API, menekan "Run Collection", dan menyaksikan Postman mengeksekusinya secara berurutan, dengan variabel yang diteruskan antar permintaan, asersi pengujian pada setiap respons, dan laporan ringkasan di akhir. Bagi pengembang yang menguji alur multi-langkah yang kompleks, ini sangat penting.

Kemudian muncul batasan tahun 2026. Sebagai bagian dari pengurangan tingkatan gratis, Postman membatasi akses Collection Runner. Akun gratis tidak dapat lagi menjalankan koleksi melebihi jumlah permintaan tertentu per bulan, dan beberapa fitur Runner sekarang sepenuhnya berbayar.

Dampaknya segera terlihat dalam alur kerja pengembang. Tim yang memiliki pipeline CI yang mengandalkan Newman (runner CLI Postman) mulai menemui batasan. Pengembang yang menjalankan tes smoke pra-deployment di Collection Runner menemukan fitur tersebut berwarna abu-abu atau dibatasi.

Apa yang Postman Ubah pada Collection Runner

Tingkatan gratis Postman sekarang membatasi Collection Runner dalam dua cara utama:

Batas jalankan bulanan. Akun gratis memiliki batasan berapa banyak eksekusi Collection Runner yang dapat mereka lakukan per bulan. Postman belum mempublikasikan angka pastinya secara jelas, tetapi laporan komunitas menempatkannya sekitar 25 jalankan per bulan. Bagi pengembang yang menjalankan pengujian beberapa kali sehari, batasan ini tercapai dalam beberapa hari.

Pembatasan Newman CLI. Newman, alat CLI sumber terbuka yang memungkinkan Anda menjalankan koleksi Postman di terminal dan lingkungan CI, sebelumnya bekerja dengan ekspor koleksi Postman apa pun tanpa menemui batasan paket. Pasca-2026, beberapa fitur Newman terhubung kembali ke tingkatan paket akun Postman Anda saat menggunakan koleksi yang disinkronkan cloud.

Eksekusi pengujian tanpa kode. Visual Collection Runner, yang dapat diakses dari bilah samping, menunjukkan status berbayar pada akun gratis setelah batas jalankan tercapai.

Apa yang tidak dibatasi: menjalankan permintaan individual secara manual (mengklik "Send" pada satu permintaan) tetap tidak terbatas. Pembatasan secara khusus menargetkan eksekusi batch otomatis.

Apa yang Rusak dalam Praktik

Tes Smoke Pra-commit dan Pra-deployment

Banyak tim menjalankan Collection Runner sebelum menggabungkan PR atau menerapkan ke staging. Jika Anda memiliki 30 permintaan dalam koleksi tes smoke Anda, tim yang terdiri dari tiga pengembang yang masing-masing menjalankannya dua kali sehari akan menghabiskan batas bulanan gratis Postman dalam waktu sekitar dua hari.

Pipeline CI/CD

Pipeline CI berbasis Newman paling terpengaruh. Alur kerja GitHub Actions seperti ini:

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json

Akan mulai gagal atau menemui kesalahan tingkat setelah batas akun tercapai. Ini sangat merugikan bagi tim dengan banyak pipeline yang memicu pada setiap push.

Suite Pengujian End-to-End

Beberapa tim membangun alur kerja API multi-langkah di Postman yang merangkai permintaan, meneruskan output satu permintaan (seperti token otentikasi) ke yang berikutnya. Collection Runner menangani ini melalui pola pm.environment.set(). Dengan Runner yang dibatasi, alur kerja ini hanya dapat diuji dengan melangkah secara manual melalui permintaan satu per satu.

Pengujian Beban dan Performa

Collection Runner Postman memiliki opsi "delay" dan "iterations" yang memungkinkan Anda menjalankan koleksi beberapa kali secara berurutan, berguna untuk pengujian beban dasar. Dengan batasan jalankan yang berlaku, kasus penggunaan ini secara efektif hilang pada tingkatan gratis.

Solusi Cepat di Dalam Postman

Jika Anda belum siap untuk beralih alat, beberapa solusi ada dalam ekosistem Postman.

Ekspor ke Newman dan jalankan secara lokal. Newman berjalan melawan file JSON koleksi yang diekspor secara lokal tanpa memerlukan login akun Postman, selama Anda tidak menggunakan fitur yang menghubungi server pusat. Ekspor koleksi dan lingkungan Anda, lalu jalankan Newman sepenuhnya offline:

newman run collection.json -e environment.json

Ini melewati batas jalankan akun Postman karena Newman membaca file lokal. Batasannya adalah Anda kehilangan sinkronisasi dengan ruang kerja Postman langsung Anda, sehingga Anda perlu mengekspor ulang setiap kali koleksi berubah.

Pecah koleksi besar menjadi bagian yang lebih kecil. Jika Anda mendekati batas bulanan, memecah koleksi 100 permintaan menjadi empat koleksi 25 permintaan berarti masing-masing menggunakan penghitung jalankan terpisah. Ini adalah solusi sementara, bukan solusi, dan ini mengganggu alur logis dari pengujian multi-langkah.

Tingkatkan secara selektif. Jika hanya satu anggota tim yang menjalankan pipeline CI, memiliki satu akun tersebut pada paket berbayar sementara yang lain tetap gratis lebih murah daripada meningkatkan semua orang. Akun berbayar menjalankan Newman tanpa batasan; yang lain menggunakan pengujian manual.

Bagaimana Cara Kerja Collection Runner Apidog Berbeda

Runner Apidog, yang disebut "Skenario Pengujian" atau dapat diakses melalui tombol "Run" pada koleksi apa pun, tidak memiliki batasan jalankan bulanan pada paket apa pun. Ini termasuk tingkatan gratis.

Berikut perbandingannya dengan apa yang dibatasi oleh Postman:

Runner CLI Apidog (apidog-cli) berintegrasi dengan CI/CD dengan cara yang sama seperti Newman. Struktur perintahnya serupa:

apidog run {project-id} --collection {collection-id} --environment {env-id}

Anda juga dapat mengekspor koleksi dari Apidog dan menjalankannya secara offline, mirip dengan pendekatan file lokal Newman, tetapi tanpa perlu khawatir tentang batasan berbasis akun.

Mengatur Runner Apidog dalam Pipeline CI Anda

Jika Anda memigrasi pipeline berbasis Newman ke Apidog, berikut adalah tampilan transisi di GitHub Actions.

Sebelumnya (Newman):

- name: Install Newman
  run: npm install -g newman

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json --reporters cli,json --reporter-json-export results.json

Sesudah (Apidog CLI):

- name: Install Apidog CLI
  run: npm install -g apidog-cli

- name: Run API tests
  run: apidog run --project {project-id} --env {env-id} --output results.json
  env:
    APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}

Perbedaan utamanya adalah mekanisme otentikasi (Apidog menggunakan token akses daripada kunci API Postman) dan referensi berbasis proyek alih-alih jalur file lokal. Keduanya mendukung output JSON untuk pelaporan hasil pengujian.

Sebagai alternatif, jika Anda lebih suka tetap menggunakan antarmuka Newman yang familiar, Anda dapat mengekspor koleksi Apidog sebagai JSON yang kompatibel dengan Postman dan terus menjalankan Newman terhadapnya. Ini memberi Anda pendekatan offline, tidak memerlukan akun, sambil bekerja dengan Apidog sehari-hari.

Fitur Runner Canggih di Apidog

Selain menyamai set fitur terbatas Postman, runner Apidog menambahkan beberapa kemampuan yang patut diketahui.

Pengujian berbasis data. Impor file CSV atau JSON ke dalam jalankan pengujian untuk mengeksekusi koleksi yang sama dengan set data yang berbeda. Setiap baris menjadi satu iterasi. Ini setara dengan fitur file data Postman, yang juga berbayar di tingkatan Postman yang lebih tinggi.

Jumlah iterasi kustom. Atur jumlah iterasi tertentu untuk jalankan pengujian tanpa khawatir tentang penghitung bulanan. Jalankan koleksi Anda 500 kali untuk pengujian stres dasar jika diperlukan.

Integrasi Smart Mock. Saat runner dieksekusi, ia dapat berinteraksi dengan server mock bawaan Apidog. Ini berarti Anda dapat menjalankan pengujian terhadap endpoint mock tanpa memulai server terpisah, berguna saat menguji kode klien terhadap API yang belum dibuat.

Jalankan terjadwal. Siapkan jalankan pengujian otomatis sesuai jadwal (per jam, harian, dll.) langsung di Apidog tanpa memerlukan pekerjaan cron eksternal atau pemicu CI. Hasilnya muncul di riwayat pengujian proyek Anda.

Pembatasan Collection Runner Postman adalah penghalang praktis bagi tim yang membangun pipeline CI dan alur kerja pengujian otomatis pada tingkatan gratis. Jalur paling langsung ke depan adalah beralih ke runner tanpa batasan penggunaan. Runner Apidog mencakup semua kasus penggunaan yang dibatasi oleh tingkatan gratis Postman, dan integrasi CLI berfungsi dalam pengaturan pipeline yang ada dengan sedikit perubahan konfigurasi.