Cara Otomatisasi Uji API di CI/CD

Anda telah membangun fitur baru yang fantastis, kodenya bersih, pengujian unit berhasil, dan Anda siap untuk menggabungkan (merge). Anda menekan tombol deploy dengan percaya diri. Namun, beberapa jam kemudian, Anda mendapatkan pesan Slack yang mengerikan: "Login rusak untuk pengguna yang sudah ada." Hati Anda mencelos. Anda tidak menyentuh layanan otentikasi! Apa yang terjadi?

Kedengarannya familiar? Ini adalah kisah perubahan API yang tidak terdeteksi. Mungkin dependensi diperbarui dan mengubah format respons, atau refaktor "tidak berbahaya" yang kecil mengubah payload penting. Dalam dunia microservices yang terhubung, efek riak ini bukanlah pengecualian; melainkan aturannya.

Di sinilah keajaiban pengujian API otomatis dalam pipeline CI/CD Anda berperan. Ini adalah jaring pengaman Anda, gerbang kualitas Anda, dan peningkat kepercayaan diri Anda, semuanya digabungkan menjadi satu. Ini adalah praktik yang memastikan kontrak API Anda dihormati dengan setiap commit, mencegah bug mencapai staging, apalagi produksi. Dan bagian terbaiknya? Ini tidak sesulit kedengarannya.

💡

Jika Anda siap untuk berhenti "memadamkan api" dan mulai mengirimkan (shipping) dengan percaya diri, Anda harus mengunduh Apidog secara gratis. Ini dibangun untuk membuat pembuatan, pengelolaan, dan yang terpenting, mengotomatiskan pengujian API Anda menjadi sangat mudah.

button

Jadi, mari kita singkap lengan baju kita dan selami dunia kualitas API berkelanjutan. Di akhir panduan ini, Anda akan tahu bagaimana mengubah pengujian API Anda dari daftar periksa manual menjadi penjaga keandalan perangkat lunak Anda yang otomatis dan didukung pipeline.

Dasar: Memilih Alat yang Tepat untuk Pekerjaan

Untuk mengotomatiskan apa pun, Anda memerlukan alat yang tepat. Klien API berbasis GUI sangat cocok untuk pengujian eksplorasi, tetapi untuk otomatisasi, Anda memerlukan sesuatu yang dapat berjalan tanpa kepala (headless) dari baris perintah dan terintegrasi dengan mulus dengan sistem seperti Jenkins, GitHub Actions, atau GitLab CI.

Di sinilah Apidog menonjol. Meskipun menyediakan antarmuka yang indah dan intuitif untuk merancang dan men-debug API Anda, ia juga dibangun dengan otomatisasi sebagai warga kelas satu. Ini memungkinkan Anda membuat skenario pengujian yang kompleks secara visual dan kemudian menjalankannya di lingkungan CI/CD apa pun dengan satu perintah. Ini menjembatani kesenjangan antara kemudahan GUI dan kekuatan alat baris perintah.

Mengapa Tim Suka Menggunakan Apidog untuk Otomatisasi Pengujian API

Berikut adalah alasan mengapa Apidog menjadi favorit di kalangan tim pengembang:

Solusi lengkap: Desain API, mocking, pengujian, debugging, dan dokumentasi dalam satu aplikasi.
Antarmuka visual: Pengaturan dan debugging yang lebih mudah dibandingkan dengan alat CLI-only manual.
Integrasi CI/CD tanpa batas: Bekerja di Jenkins, GitHub, GitLab, dan lainnya.
Manajemen lingkungan: Uji skenario yang sama di berbagai pengaturan.
Ramah kolaborasi: Bagikan skenario, lacak laporan pengujian, dan kelola akses dalam tim.

button

Ketika digabungkan, fitur-fitur ini mengubah Apidog menjadi bukan hanya alat pengujian, tetapi platform otomatisasi siklus hidup API yang lengkap.

Membangun Suite Pengujian API Otomatis di Apidog (Langkah demi Langkah)

Sebelum kita dapat menjalankan pengujian di pipeline, kita perlu membuatnya. Apidog menggunakan konsep "Skenario Pengujian" untuk mengelompokkan dan mengurutkan pengujian API Anda, yang sempurna untuk memodelkan alur pengguna.

Langkah 1: Buat Skenario Pengujian Baru

Di dalam proyek Apidog Anda, Anda akan menemukan opsi untuk membuat "Skenario Pengujian." Ini adalah suite atau koleksi pengujian Anda. Beri nama yang jelas dan deskriptif, seperti "Alur Otentikasi Pengguna" atau "Pengujian E2E Pemrosesan Pesanan."

Langkah 2: Rancang dan Tambahkan Permintaan API ke Langkah Pengujian

Di sinilah Anda membangun langkah-langkah individual dari pengujian Anda. Anda dapat menambahkan permintaan baru langsung dalam skenario atau, bahkan lebih baik, mengimpornya dari bagian "Desain API" yang ada di Apidog. Ini mendorong penggunaan kembali, permintaan yang sama yang Anda gunakan untuk debugging dapat menjadi bagian dari pengujian otomatis.

Alur tipikal mungkin terlihat seperti ini:

POST /api/v1/login: Otentikasi pengguna dan simpan token yang diterima.
GET /api/v1/users/me: Ambil profil pengguna menggunakan token yang disimpan.
POST /api/v1/orders: Buat pesanan baru untuk pengguna yang diautentikasi.
GET /api/v1/orders/{order_id}: Validasi bahwa pesanan dibuat dengan benar.

Rancang dan Tambahkan Permintaan API ke Langkah Pengujian

Langkah 3: Tambahkan Asersi yang Kuat

Mengirim permintaan saja tidak cukup—Anda perlu memvalidasi responsnya. Apidog mendukung asersi berbasis JavaScript seperti:

Kode Status: pm.response.to.have.status(200);
Isi Respons: pm.expect(pm.response.json().data.email).to.eql("test@example.com");
Header Respons: pm.response.to.have.header("Content-Type", "application/json");
Performa: pm.expect(pm.response.responseTime).to.be.below(500); // 500ms

Pemeriksaan ini dapat menentukan apakah pengujian Anda berhasil atau gagal.

Langkah 4: Rantai Permintaan dengan Variabel

Perantaian adalah yang memungkinkan alur kerja multi-langkah.

Anda dapat mengekstrak data dari satu respons dan menggunakannya kembali dalam permintaan selanjutnya.
Misalnya, setelah login, simpan token otentikasi:

const jsonData = pm.response.json();
pm.collectionVariables.set("auth_token", jsonData.access_token);

Kemudian gunakan {{auth_token}} di header Otorisasi dari permintaan berikut.

Ini menciptakan alur pengujian dinamis dan realistis yang mencerminkan perilaku pengguna sebenarnya.

Langkah 5: Konfigurasi Lingkungan Jalankan untuk Pengujian API

Pipeline Anda akan menjalankan pengujian terhadap lingkungan tertentu—seperti Staging, CI, atau Testing.

Lingkungan ini menyimpan variabel seperti:

base_url
Kunci API
token
data seed database

Ini memastikan pengujian otomatis Anda selalu menunjuk ke server yang benar tanpa memodifikasi kode apa pun.

Mengintegrasikan Pengujian API ke dalam CI/CD

Sekarang untuk acara utama: membuat pengujian ini berjalan secara otomatis. Apidog menyediakan alat CLI (Command Line Interface) khusus untuk tujuan ini.

Langkah 1: Orkestrasikan skenario pengujian dan debug hingga berhasil.

Langkah 2: Beralih ke tab CI/CD, atur parameter lingkungan, data pengujian, dan konfigurasi lain yang diperlukan. Pelajari lebih lanjut tentang konfigurasi Apidog CLI.

Langkah 3: Pilih platform CI/CD Anda, dan salin perintah yang sesuai untuk dikonfigurasi di platform CI/CD Anda.

Langkah 4: Jalankan pipeline dan dapatkan hasilnya di platform CI/CD Anda.

Tonton tutorial langkah demi langkah ini untuk detail lebih lanjut:

Mengapa Mengotomatiskan Pengujian API di CI/CD Tidak Dapat Ditawar

Pertama, mari kita perkuat mengapa ini sangat penting. Tentu, menjalankan beberapa koleksi Postman secara manual sebelum rilis lebih baik daripada tidak sama sekali. Tetapi dalam lingkungan Agile atau DevOps yang serba cepat, itu saja tidak cukup.

Tangkap Perubahan Merusak Secara Instan: Pembaruan backend yang tiba-tiba merusak aplikasi seluler? Suite pengujian API otomatis akan menandainya saat permintaan pull dibuka, jauh sebelum mencapai cabang utama.
Aktifkan Pengiriman Berkelanjutan Sejati: Anda tidak dapat memiliki pengiriman "berkelanjutan" jika Anda mengandalkan gerbang pengujian manual. Pengujian API otomatis menyediakan umpan balik yang cepat dan andal yang diperlukan untuk menerapkan (deploy) secara sering dan aman.
Uji Apa yang Sebenarnya Dilakukan Pengguna: Pengujian unit sangat bagus untuk menguji fungsi secara terpisah, tetapi pengujian API memvalidasi titik akhir (endpoint) aktual yang dikonsumsi oleh frontend, aplikasi seluler, dan layanan lainnya. Ini adalah pengujian integrasi yang mencerminkan penggunaan dunia nyata.
Hemat Waktu yang Sangat Besar: Siklus pengujian regresi manual sebelum rilis adalah pemborosan waktu yang besar bagi pengembang dan QA. Mengotomatiskan ini membebaskan tim Anda untuk fokus pada pengujian eksplorasi dan pengembangan fitur yang lebih kompleks.
Dokumentasikan API Anda Melalui Perilaku: Suite pengujian API otomatis yang ditulis dengan baik berfungsi sebagai dokumentasi hidup, dengan jelas menunjukkan bagaimana API Anda diharapkan berperilaku dalam berbagai kondisi.

Singkatnya, mengotomatiskan pengujian API Anda mengubahnya dari artefak pasif menjadi bagian aktif dan penegak dari proses pengembangan Anda.

Kesimpulan: Otomatiskan Lebih Cerdas, Bukan Lebih Keras

Perjalanan dari menjalankan pengujian API secara manual hingga menjalankannya secara otomatis dengan setiap perubahan kode adalah salah satu peningkatan produktivitas dan kualitas paling signifikan yang dapat dilakukan oleh tim pengembangan. Ini menggeser pola pikir tim Anda dari "menemukan bug" menjadi "mencegah bug."

Apidog bertindak sebagai jembatan sempurna dalam perjalanan ini. Antarmuka intuitifnya menurunkan hambatan untuk membuat pengujian API multi-langkah yang canggih, sementara CLI yang kuat dan integrasi CI/CD-nya menjadikan otomatisasi sebagai kenyataan praktis. Anda tidak perlu memilih antara pengalaman pengembang yang hebat dan otomatisasi yang kuat; Anda mendapatkan keduanya dalam satu platform.

Jadi, berhentilah berharap pengujian manual Anda menangkap semuanya. Berhentilah memadamkan api yang disebabkan oleh penyimpangan API yang tidak terdeteksi. Mulailah membangun suite pengujian API otomatis Anda hari ini dan ubah pipeline CI/CD Anda menjadi sistem yang andal dan mengatur diri sendiri yang melindungi kualitas produk Anda 24/7. Pengguna Anda, tim Anda, dan diri Anda di masa depan akan tidur lebih nyenyak karenanya.

button