Apidog membedakan antara endpoint dan kasus debugging. Setiap endpoint dapat memiliki beberapa kasus debugging yang ditautkan kepadanya. Saat Anda memperbarui URL atau parameter endpoint, semua kasus debugging terkait akan diperbarui secara otomatis — tanpa upaya tambahan.Sebagai perbandingan, Postman menangani semuanya sebagai permintaan terpisah yang berdiri sendiri. Ini berarti jika Anda melakukan perubahan pada URL atau parameter, Anda perlu memperbarui secara manual setiap permintaan yang terdampak satu per satu.
Saat Anda mengirim permintaan atau melakukan debugging di tab Run pada suatu endpoint, jika Anda ingin menyimpan permintaan tersebut secara permanen, Anda dapat mengeklik Save as case. Tindakan ini akan mempertahankan permintaan sebagai kasus debugging dalam struktur endpoint.
Anda dapat menamai kasus debugging dan memilih apakah akan menyimpan respons secara bersamaan.
Sebagaimana disebutkan sebelumnya, spesifikasi endpoint disimpan di dalam endpoint, sedangkan nilainya disimpan dalam kasus debugging. Secara khusus, kasus debugging mencakup data berikut:
Nilai parameter permintaan: Mencakup parameter path, parameter query, parameter header, dan parameter body dalam format form-data.
Konten body: Dalam format seperti RAW, JSON, XML, dan sebagainya.
Pemroses pra- dan pascapermintaan.
Detail respons yang diterima.
Pengaturan validasi respons: Menunjukkan apakah validasi diaktifkan dan menentukan respons mana yang akan digunakan sebagai acuan validasi.
Oleh karena itu, jika Anda memodifikasi spesifikasi suatu parameter dalam spesifikasi endpoint, kasus debugging akan diperbarui secara real-time.
Mereferensikan Kasus Debugging dalam Pengujian Otomatis#
Kasus debugging dapat direferensikan sebagai langkah pengujian dalam skenario pengujian otomatis. Saat direferensikan, parameter permintaan dalam kasus debugging akan diterapkan langsung ke langkah pengujian. Anda dapat melihat notifikasi yang jelas bahwa setiap perubahan yang dilakukan pada kasus debugging akan secara otomatis memperbarui semua langkah pengujian yang mereferensikannya.Klik ikon referensi di sudut kanan atas untuk melihat skenario pengujian mana yang mereferensikan kasus debugging dan jumlah total skenario pengujian yang menggunakannya. Ini memberi Anda gambaran umum tentang bagaimana kasus tersebut digunakan dalam pengujian otomatis.
Mengeklik suatu skenario pengujian akan membawa Anda ke halaman detail skenario, tempat langkah-langkah terkait yang menggunakan kasus tersebut disorot agar mudah dilihat.
Mengeklik langkah pengujian yang mereferensikan kasus debugging akan memberi tahu Anda bahwa setiap perubahan akan disinkronkan dengan kasus asli.
Praktik Terbaik untuk Menggunakan Kasus Debugging#
1.
Tentukan spesifikasi API secara menyeluruh.
2.
Buat beberapa kasus debugging untuk setiap endpoint guna mencakup berbagai kondisi.
3.
Untuk setiap kasus debugging, tulis aservi atau pemroses pra- dan pascapermintaan lainnya.
4.
Referensikan kasus debugging dalam pengujian otomatis untuk menyusun skenario pengujian.
5.
Jika terdapat pembaruan pada spesifikasi API, baik kasus debugging maupun skenario pengujian dapat disinkronkan. Anda dapat memilih untuk memperbarui skenario pengujian secara manual atau mengaturnya agar diperbarui secara otomatis.