Mulai dari Apidog versi 2.7.29, Anda kini dapat menambahkan kasus pengujian langsung pada halaman detail endpoint.
Setiap kasus pengujian merepresentasikan sekumpulan parameter permintaan untuk endpoint. Pengguna dapat mengatur dan mengelola semua kasus pengujian secara sistematis, lalu menjalankannya dengan satu klik untuk menyelesaikan pengujian pada endpoint saat ini.
Kasus Pengujian vs. Kasus Debug
Kasus pengujian
Tujuan: Untuk memverifikasi apakah endpoint berperilaku sesuai harapan di berbagai skenario permintaan, dengan fokus pada kelengkapan.
Mencakup berbagai skenario: positif, negatif, batas, dan keamanan.
Biasanya lebih jarang dimodifikasi atau dijalankan.
Kasus debug
Tujuan: Untuk memverifikasi respons endpoint dengan cepat selama pengembangan atau pemecahan masalah, dengan fokus pada kecepatan.
Umumnya terbatas pada skenario dasar seperti keberhasilan dan kegagalan.
Sering dimodifikasi dan dijalankan secara berkala.
Saat menambahkan kasus pengujian, Anda dapat memilih Import from Debug Cases untuk menyalin atau memindahkan kasus debug yang sudah ada ke dalam kasus pengujian.
Salin: Gunakan ini ketika Anda masih memerlukan kasus debug untuk validasi cepat, tetapi juga ingin menjadikannya sebagai kasus pengujian.
Pindahkan: Gunakan ini ketika kasus debug tidak lagi sering digunakan untuk debugging dan terutama ditulis untuk menguji pengecualian. Ini akan langsung mengonversinya menjadi kasus pengujian, sehingga migrasi menjadi lebih cepat jika kasus pengujian awalnya dibuat sebagai kasus debug.
Grup: Diatur berdasarkan tujuan pengujian (positif, negatif, batas, dll.).
Nama Kasus: Nama kasus pengujian.
Parameter Permintaan: Parameter Path, Query, Header, dan body form-data.
Body Permintaan: Mendukung RAW, JSON, XML, dll.
Pre/Post Processors
Validasi Respons: Aktifkan/nonaktifkan validasi dan tentukan komponen respons yang akan divalidasi.
[!NOTE] Karena kasus pengujian lebih jarang diperbarui, kasus tersebut harus disinkronkan secara manual dengan perubahan endpoint. Misalnya, jika field baru ditambahkan ke endpoint, Anda perlu mengeklik Update pada kasus pengujian untuk memperbaruinya.
Setiap pengeditan pada detail kasus pengujian harus disimpan dengan mengeklik Save. Jika ada perubahan yang belum disimpan, sistem akan memberi tahu Anda.
Pada tab Test Cases, Anda dapat mengelola semua kasus pengujian yang telah dibuat. Gunakan fitur pencarian dan filter di sudut kiri atas untuk menemukan kasus pengujian yang Anda perlukan dengan mudah. Anda juga dapat menggunakan tab grup untuk melihat kasus pengujian berdasarkan grup dengan cepat. Untuk operasi pada kasus pengujian tertentu:
Satu Kasus Pengujian: Anda dapat membuka tab baru untuk melihat, memodifikasi, dan menjalankan kasus pengujian. Operasi dasar mencakup menyalin, memindahkan kasus pengujian ke grup lain, menyalin cURL kasus pengujian, dan menghapus kasus pengujian.
Beberapa Kasus Pengujian: Ketika Anda memilih beberapa kasus pengujian dalam daftar, tombol tindakan akan muncul di sudut kanan atas, memungkinkan Anda melakukan pengelompokan batch, penghapusan, dan sinkronisasi dengan pembaruan endpoint.
Saat melihat kasus pengujian, klik tombol Run untuk mengirim permintaan dengan parameternya. Respons aktual kemudian akan ditampilkan.
Anda juga dapat menggunakan Run All atau memilih beberapa kasus pengujian dari daftar dan menjalankannya bersama-sama. Antarmuka akan menampilkan kasus mana yang sedang berjalan dan mana yang sudah memiliki hasil.
Setelah menjalankan batch, Anda dapat membuka kasus pengujian untuk melihat hasil eksekusinya secara langsung.
Pengujian satu endpoint biasanya melibatkan dua peran: developer backend dan engineer QA.
Developer Backend: Menulis dan men-debug kode endpoint.
Engineer QA: Melakukan pengujian API secara komprehensif dan mengidentifikasi masalah.
Dengan Apidog yang kini mendukung kasus pengujian untuk endpoint, alur kerja dapat menjadi lebih efisien:
Engineer QA dapat langsung menulis dan mengelola kasus pengujian unit di dalam dokumentasi endpoint.
Developer dapat menggunakan kasus pengujian yang sudah ada untuk menjalankan pengujian, melihat hasil, dan memperbaiki masalah sendiri — tanpa menunggu umpan balik dari engineer QA atau komunikasi yang panjang.
Alur Kerja Praktik Terbaik:
Alur kerja ini dapat meningkatkan efisiensi kolaborasi:
1.
Kasus pengujian dapat ditulis segera setelah dokumentasi endpoint diselesaikan, dan dapat dilihat oleh semua anggota tim di Apidog.
2.
Developer dapat menguji endpoint sendiri setelah debugging—tidak perlu menunggu engineer QA.
3.
Developer dapat memperbaiki masalah secara langsung berdasarkan hasil pengujian—tidak diperlukan tiket tambahan atau serah terima.
4.
Hasil pengujian yang jelas membuat penjelasan masalah menjadi mudah, sehingga menghindari miskomunikasi.
