Ikhtisar

Pra-prosesor dan pasca-prosesor adalah fitur utama di Apidog. Saat Anda mengirim permintaan, Anda dapat menggunakan pra-prosesor untuk mengontrol permintaan secara dinamis, atau menggunakan pasca-prosesor untuk menangani respons yang diterima.

Apidog menyediakan antarmuka visual seret-dan-letakkan untuk operasi pra- dan pasca-permintaan, yang melengkapi pendekatan tradisional berbasis skrip. Antarmuka visual ini memungkinkan Anda mengonfigurasi operasi umum tanpa menulis kode, sambil tetap mendukung skrip khusus untuk kasus penggunaan tingkat lanjut.

Mulai Cepat

Berikut adalah langkah-langkah untuk menggunakan pra-prosesor dan pasca-prosesor di Apidog:

Buka endpoint apa pun dan navigasikan ke tab Run (Mode Design-first) atau tab Request (mode Request-first).

Mode Design-first

Mode Request-first

Beralih ke bagian Pre Processors atau Post Processors, arahkan kursor ke + Add, lalu pilih prosesor yang diinginkan.

Isi bidang yang diperlukan untuk prosesor yang ditambahkan.

Klik Send, dan permintaan akan dieksekusi dengan pra/pasca-prosesor yang telah dikonfigurasi.

Dalam Mode Design-first, klik Save as case untuk menyimpan permintaan. Dalam Mode Request-first, klik Save atau Save as case untuk menyimpan permintaan.

Mode Design-first

Mode Request-first

TIP

Anda juga dapat membuat permintaan mandiri dan menerapkan pra/pasca-prosesor padanya. Namun, kami merekomendasikan pemanfaatan pra/pasca-prosesor di atas spesifikasi endpoint agar debugging dan pengujian lebih terarah.

Kemampuan

Pra-prosesor dan pasca-prosesor secara bersama-sama dapat mencapai berbagai fungsionalitas:

Pra-Prosesor

Pengaturan Parameter Permintaan: Mendefinisikan data input secara dinamis untuk endpoint API.

Konfigurasi Header: Menentukan header seperti Content-Type, Accept, dan Authorization.

Autentikasi: Menambahkan token, kunci API, atau kredensial untuk endpoint yang dilindungi.

Integrasi Database: Mengambil nilai dari database untuk digunakan sebagai parameter permintaan.

Enkripsi: Mengamankan payload permintaan sebelum transmisi.

Pasca-Prosesor

Aservi: Memvalidasi respons yang diterima terhadap hasil yang diharapkan (kode status, konten body, dll.).

Ekstraksi Variabel: Mengekstrak nilai dari respons untuk digunakan dalam permintaan berikutnya.

Operasi Database: Menulis data respons ke database untuk penyimpanan atau pembaruan.

Visualisasi Data: Menghasilkan laporan atau representasi visual dari data respons.

TIP

Operasi pra- dan pasca-tertentu dapat memicu perintah otorisasi keamanan saat mengakses database, menjalankan program eksternal, atau memuat paket npm secara dinamis. Anda dapat menavigasikan ke pengaturan Security untuk melakukan prakonfigurasi cakupan otorisasi ini.

Prosesor yang Tersedia

Apidog mendukung pra/pasca-prosesor berikut:

Prosesor	Jenis	Deskripsi
Assertion	Post	Mendefinisikan aturan validasi untuk memeriksa data respons terhadap nilai yang diharapkan (kode status, body, header).
Extract Variable	Post	Mengekstrak nilai dari respons (JSON, XML, Teks) dan menyimpannya sebagai variabel menggunakan JSONPath atau XPath.
Database Operation	Pre/Post	Terhubung ke database SQL/NoSQL untuk mengeksekusi kueri. Hasil dapat disimpan sebagai variabel.
Custom Scripts	Pre/Post	Menulis kode JavaScript khusus untuk menangani logika kompleks. Mengakses data permintaan/respons dan variabel lingkungan.
Public Scripts	Pre/Post	Membuat cuplikan skrip yang dapat digunakan kembali dan dibagikan di berbagai prosesor atau skenario.
Wait	Pre/Post	Menambahkan jeda sebelum atau sesudah permintaan, berguna untuk menyimulasikan latensi dunia nyata.

Kami merekomendasikan penggunaan Apidog Script Generator untuk menyederhanakan penulisan skrip. Jelaskan logika Anda dalam bahasa alami, dan generator akan membuat skrip yang dapat dijalankan untuk Anda.

Urutan Eksekusi

Pra-prosesor dan pasca-prosesor dapat dikonfigurasi pada beberapa tingkat:

Tingkat Run/Kasus Endpoint (Default): Hanya memengaruhi run/kasus saat ini.

Tingkat Endpoint: Berlaku untuk semua kasus yang terkait dengan endpoint.

Tingkat Folder: Memengaruhi semua endpoint di dalam folder.

Tingkat Proyek: Berlaku untuk semua permintaan di dalam proyek (cakupan tertinggi).

Eksekusi mengalir dari tingkat tertinggi (Proyek/Folder) turun ke tingkat Run/Kasus tertentu.

Memvisualisasikan Eksekusi

Serangkaian pra-prosesor dalam sebuah permintaan dapat terlihat seperti ini:

Pada tangkapan layar di atas:

Tiga prosesor pertama dikelompokkan di bawah Inherit from parent. Prosesor tersebut didefinisikan di folder Root, folder tertentu (misalnya, "Pets"), atau endpoint itu sendiri.

Prosesor yang diwariskan ini bersifat hanya-baca dalam run saat ini, tetapi dapat diaktifkan/dinonaktifkan.

Prosesor terakhir adalah skrip khusus yang ditambahkan secara spesifik untuk run ini dan dapat diedit secara langsung.

Substitusi Variabel

Anda mungkin melihat langkah yang disebut Variable Substitution & Inherit from Parents. Pra-prosesor khusus ini mengganti placeholder seperti {{variable}} dengan nilai aktualnya.

Perilaku Default: Sebagian besar pra-prosesor dieksekusi sebelum substitusi variabel.

Pasca-Substitusi: Beberapa skrip (misalnya, penandatanganan API) harus dijalankan setelah variabel diganti. Anda dapat menyeret prosesor ini secara manual ke bawah langkah "Variable Substitution".

Alur Eksekusi Lengkap

Urutan eksekusi terperinci untuk satu permintaan adalah sebagai berikut:

Mulai Cepat#

Kemampuan#

Pra-Prosesor#

Pasca-Prosesor#

Prosesor yang Tersedia#

Urutan Eksekusi#

Memvisualisasikan Eksekusi#

Substitusi Variabel#

Alur Eksekusi Lengkap#

Mulai Cepat

Kemampuan

Pra-Prosesor

Pasca-Prosesor

Prosesor yang Tersedia

Urutan Eksekusi

Memvisualisasikan Eksekusi

Substitusi Variabel

Alur Eksekusi Lengkap