Apidog adalah platform kolaborasi dan pengembangan API yang membantu tim backend, frontend, dan QA bekerja lebih efisien. Untuk para insinyur QA, Apidog menawarkan berbagai fitur pengujian, termasuk pengujian unit, pengujian integrasi, pengujian berbasis data, pengujian kinerja, pengujian regresi, CI/CD, dan pemantauan terjadwal.
Mari kita telusuri alur kerja lengkap untuk para insinyur QA yang menggunakan Apidog, dimulai dengan dasar-dasarnya.
Persiapan Awal
Langkah pertama untuk memulai pengujian API adalah mendapatkan dokumentasi API yang terperinci. Apidog mempermudah hal ini dengan memungkinkan Anda untuk mengimpor dokumentasi API yang ada secara langsung. Ini menghilangkan kebutuhan untuk memasukkan setiap endpoint secara manual. Cukup buka Project Settings -> Import Data dan pilih format data yang sesuai untuk diimpor.
Pengujian Unit
Pengujian unit adalah bagian penting dari proses pengujian. Ini memastikan bahwa setiap API berfungsi seperti yang diharapkan dalam kondisi yang berbeda. Insinyur QA menulis kasus pengujian terperinci untuk mencakup berbagai skenario, seperti kasus normal, luar biasa, dan tepi. Ini memastikan API menangani semua kemungkinan input.
Misalnya, endpoint "Query Pet Details" memerlukan ID hewan peliharaan sebagai parameter untuk mengambil detail hewan peliharaan. Insinyur QA dapat memasukkan petId=123 di halaman "Run" Apidog dan mengirimkan permintaan. Kemudian, mereka dapat memeriksa apakah detail hewan peliharaan yang benar dikembalikan.
Untuk mengotomatiskan pengujian, pernyataan dapat ditambahkan di post-processor. Pernyataan ini memeriksa apakah ID hewan peliharaan yang benar muncul dalam respons di bawah bidang data. Dengan menggunakan ekspresi JSONPath $.data.id dan mengatur pernyataan ke Exists, ID hewan peliharaan dapat diekstraksi dan divalidasi secara otomatis.
Anda juga dapat mengekstraksi pernyataan langsung dari respons yang dikembalikan.
Setelah langkah-langkah ini selesai, kasus pengujian dapat disimpan. Kasus pengujian normal dan abnormal tambahan dapat dibuat sesuai kebutuhan, seperti "Pets Available for Sale", "Pets Sold", "Record Not Found", dan "Incorrect ID Format". Kasus pengujian yang disimpan ini dapat dijalankan dengan cepat dan mudah di pengujian regresi di masa mendatang untuk memverifikasi stabilitas fungsi inti.
Pengujian Integrasi
Menguji API individual itu penting, tetapi aplikasi nyata sering kali membutuhkan beberapa API untuk bekerja bersama. Pengujian integrasi memastikan bahwa API ini berinteraksi dengan benar. Ini mensimulasikan tindakan pengguna nyata dan menguji pertukaran data dan alur kerja antar API.
Misalnya, dalam proses pembelian hewan peliharaan, pengguna dapat menelusuri daftar hewan peliharaan, menambahkan hewan peliharaan ke keranjang, melakukan pemesanan, melakukan pembayaran, dan melihat detail pesanan. Insinyur QA dapat membuat skenario pengujian di Apidog, menambahkan kasus pengujian untuk setiap endpoint yang terlibat dalam proses tersebut.
Transfer data antar endpoint sangat penting untuk memastikan proses pengujian selesai. Ambil contoh alur pembelian hewan peliharaan. Insinyur QA dapat meneruskan ID pesanan antar langkah dalam dua cara:
- Metode 1: Setelah menjalankan endpoint "Create Order", simpan ID pesanan yang dihasilkan sebagai variabel dan gunakan dalam endpoint pembayaran dan kueri pesanan berikutnya.
- Metode 2: Langsung gunakan nilai kembalian dari endpoint "Create Order" di endpoint pembayaran dan kueri pesanan (metode ini lebih mudah dan direkomendasikan).
Untuk operasi batch, seperti menambahkan beberapa hewan peliharaan ke keranjang, loop ForEach dapat ditambahkan. Atur array loop ke daftar hewan peliharaan.
ID hewan peliharaan akan dimasukkan secara otomatis, membuat operasi massal lebih mudah.
Setelah semuanya diatur, jalankan skenario pengujian. Ini akan menghasilkan laporan pengujian terperinci. Insinyur QA kemudian dapat dengan cepat menemukan dan memperbaiki masalah apa pun.
Pengujian Berbasis Data
Dalam beberapa kasus, endpoint yang sama perlu diuji dengan beberapa set data. Fitur pengujian berbasis data Apidog membantu dengan ini. Insinyur QA dapat mengimpor file CSV yang berisi set data yang berbeda. Set ini kemudian dapat digunakan dalam skenario pengujian untuk menjalankan pengujian secara otomatis.
Berikut cara kerjanya: Insinyur QA membuat skenario pengujian baru, menambahkan endpoint "Create Pet Information", dan mengimpor file CSV ke dalam Test Data. Setiap baris (dengan baris pertama adalah nama variabel) dalam file CSV mewakili satu set data yang dapat digunakan dalam permintaan API.
Referensi variabel ini dalam badan JSON permintaan endpoint untuk memetakan data dari file CSV.
Pilih data pengujian dan lingkungan yang sesuai, lalu jalankan pengujian. Apidog akan secara otomatis menjalankan kasus endpoint untuk setiap set data, menghasilkan status eksekusi dan laporan untuk setiap putaran.
Dengan mengotomatiskan pengujian massal dengan cara ini, Apidog secara signifikan meningkatkan efisiensi dan akurasi proses pengujian.
Pengujian Kinerja
Setelah fungsi dasar endpoint divalidasi, langkah selanjutnya adalah pengujian kinerja. Ini memeriksa bagaimana sistem bekerja di bawah lalu lintas yang padat. Apidog menyediakan alat pengujian kinerja yang mensimulasikan beberapa pengguna virtual untuk menguji respons sistem.
Misalnya, dalam skenario pemesanan, insinyur QA dapat mengatur jumlah pengguna virtual (misalnya, 10), durasi pengujian, dan waktu peningkatan (misalnya, 1 menit). Selama pengujian, Apidog menghasilkan grafik waktu nyata yang menunjukkan metrik utama seperti permintaan per detik, waktu respons server, dan tingkat kesalahan. Ini membantu insinyur QA mengidentifikasi hambatan kinerja dan mengoptimalkan sesuai dengan itu.
Pengujian Regresi
Saat sistem berkembang, fitur baru dapat memengaruhi fungsi yang ada. Pengujian regresi memastikan bahwa pembaruan baru tidak merusak fitur inti. Di Apidog, insinyur QA dapat membuat folder pengujian regresi dan menambahkan skenario pengujian utama. Sebelum setiap rilis, mereka dapat menjalankan pengujian ini secara massal untuk memastikan bahwa semuanya berfungsi seperti yang diharapkan.
Integrasi CI/CD
Dalam alur kerja pengembangan modern, Integrasi Berkelanjutan (CI) dan Penerapan Berkelanjutan (CD) sangat penting untuk mempertahankan siklus rilis yang cepat dan kode berkualitas tinggi. Apidog terintegrasi dengan mulus dengan alat CI/CD seperti Jenkins, memungkinkan pengujian otomatis untuk dijalankan sebagai bagian dari pipeline build.
Insinyur QA dapat pergi ke halaman CI/CD dalam skenario pengujian tertentu, memilih lingkungan dan data pengujian yang sesuai, dan mengaktifkan notifikasi untuk hasil pengujian (mendukung berbagai metode notifikasi seperti Email, Slack, Webhook dan Jenkins, dll.). Selanjutnya, pilih alat CI/CD yang sesuai, salin perintah yang dihasilkan, dan konfigurasikan di Jenkins atau alat build lainnya.
Penting untuk menghasilkan dan mengonfigurasi Access Token selama proses integrasi untuk memastikan otentikasi dan komunikasi yang lancar dengan Jenkins. Setelah dikonfigurasi, Apidog akan secara otomatis menjalankan pengujian setiap kali build dipicu dan mengirimkan hasil pengujian ke tim melalui metode notifikasi yang dipilih, meningkatkan efisiensi kolaborasi.
Tugas Terjadwal untuk Pengujian API
Terkadang, perlu menjalankan pengujian secara teratur untuk memastikan sistem tetap stabil. Fitur tugas terjadwal Apidog memungkinkan insinyur QA untuk mengotomatiskan proses ini. Mereka dapat menjadwalkan pengujian untuk dijalankan pada waktu tertentu dan mendapatkan notifikasi tentang hasilnya.
Sebelum menggunakan fitur ini, insinyur QA perlu menginstal Runner Apidog di server. Ini memastikan bahwa tugas terjadwal dapat berjalan secara independen di server tanpa bergantung pada komputer lokal yang menyala. Setelah instalasi, insinyur QA dapat membuat tugas terjadwal baru, memilih skenario pengujian, mengatur mode dan server jalankan, dan mengaktifkan notifikasi.
Setelah tugas berjalan, Apidog mencatat hasilnya dan mengirimkannya ke tim, membantu dengan cepat menemukan dan memperbaiki masalah apa pun.
Kesimpulan Akhir
Apidog menyediakan serangkaian fitur komprehensif yang secara signifikan menyederhanakan siklus hidup pengujian API, dari persiapan awal hingga pemantauan berkelanjutan. Dengan kemampuan yang kuat dalam pengujian unit, integrasi, berbasis data, kinerja, regresi, dan CI/CD, serta tugas terjadwal, Apidog memastikan pengujian API yang efisien, andal, dan terukur. Dengan mengintegrasikan Apidog ke dalam alur kerja pengujian Anda, tim dapat menghemat waktu, mengurangi kesalahan, dan memberikan API berkualitas tinggi lebih cepat, yang mengarah pada peningkatan stabilitas dan kinerja sistem.
