Klik Send di tab Run pada endpoint untuk mengirim permintaan.Antarmuka Run di Endpoint dan antarmuka Request sangat mirip. Perbedaan utamanya adalah Run berbasis pada endpoint; antarmuka ini dapat menghasilkan permintaan dan memvalidasi respons berdasarkan spesifikasi endpoint. Ketika spesifikasi endpoint berubah, antarmuka Run juga akan diperbarui sesuai dengan perubahan tersebut. Di sisi lain, Requests bersifat independen dan tidak terkait dengan spesifikasi API.
Saat Anda mengirim permintaan, Apidog menampilkan respons yang diterima dari server API dengan cara yang memungkinkan Anda memeriksa, memvisualisasikan, dan memecahkan masalahnya.
Antarmuka ini dibagi menjadi dua bagian: bagian atas adalah tempat Anda memasukkan permintaan yang ingin dikirim, dan bagian bawah menampilkan permintaan yang benar-benar Anda kirim, respons yang Anda terima, serta hasil validasi dan aservi untuk respons tersebut.
TIP
Anda dapat mengarahkan kursor ke tombol partition di sudut kanan bawah untuk menyesuaikan tata letak antarmuka Run. Anda dapat memilih untuk membagi antarmuka secara horizontal, vertikal, atau tanpa pembagian.
Di bagian atas, Anda dapat memanfaatkan variabel, nilai dinamis, skrip, dan sebagainya untuk menyesuaikan permintaan yang Anda kirim. Bagaimana cara melihat permintaan aktual yang dikirim? Anda dapat melihat permintaan aktual lengkap di tab Actual Request pada bagian bawah.
Apidog secara otomatis memvalidasi apakah respons sesuai dengan skema berdasarkan spesifikasi endpoint. Anda dapat memilih untuk mengaktifkan atau menonaktifkan validasi, serta memilih respons mana yang akan digunakan sebagai acuan validasi.
Anda dapat memodifikasi permintaan di tab Run. Anda dapat mengubah nilai parameter atau mengaktifkan/menonaktifkan kotak centang di depan parameter untuk mengubah permintaan. Tindakan ini tidak bertentangan dengan spesifikasi endpoint.Terkadang, Anda mungkin perlu memodifikasi jenis parameter atau menambah/menghapus parameter. Dalam kasus ini, permintaan menyimpang dari spesifikasi endpoint. Di Apidog, ketidaksesuaian ini disorot dengan warna oranye.
Mengarahkan kursor ke penanda oranye ini akan menampilkan perbedaan antara spesifikasi dan permintaan saat ini. Anda dapat mengeklik Revert untuk mengembalikannya ke keadaan yang sesuai dengan spesifikasi, atau mengeklik Save to endpoint spec untuk memperbarui spesifikasi. Anda juga dapat mengeklik tombol Inconsistent di sudut kanan atas untuk mengembalikan secara massal atau menyimpan semua perbedaan ke spesifikasi endpoint.
Di tab Run, tidak terdapat tombol Save. Hal ini karena, untuk spesifikasi endpoint, spesifikasi tersebut tidak mencakup konten permintaan.Untuk kemudahan debugging, Apidog menyediakan tombol Stash. Mengeklik Stash akan menyimpan konten saat ini di antarmuka Run tanpa memengaruhi spesifikasi endpoint, dan konten tersebut tidak akan disinkronkan dengan pihak lain.
Jika Anda ingin menyimpan permintaan secara persisten, Anda dapat mengeklik Save as case. Permintaan ini akan disimpan dalam bentuk endpoint case di bawah hierarki endpoint.
Anda dapat menyimpan setiap skenario penggunaan endpoint ini sebagai endpoint case, sehingga memudahkan debugging oleh pengembang dan menyediakan cara yang mudah untuk mengimpornya ke pengujian otomatis sebagai sebuah langkah.
Saat mengimpor Postman Collection, setiap permintaan Postman sesuai dengan satu endpoint case di Apidog. Oleh karena itu, semuanya akan ditampilkan sebagai case success di bawah hierarki endpoint, bukan di dalam spesifikasi endpoint. Pelajari lebih lanjut tentang migrate from Postman.
T: Mengapa permintaan yang sama berfungsi dengan benar di alat lain (seperti Postman), tetapi tidak di Apidog?J: Jika permintaannya identik, maka responsnya juga seharusnya identik terlepas dari alat yang digunakan. Jika Anda mendapatkan respons yang berbeda, Anda dapat beralih ke tab Actual Request dan membandingkan permintaan yang Anda kirim di alat lain untuk mengidentifikasi perbedaannya.
