Sesi perekaman

Sebuah sesi perekaman mengamati sebuah halaman web selagi Anda menggunakannya dan mencatat setiap panggilan API yang dilakukannya: REST, GraphQL, gRPC-web, dan WebSocket. Panggilan yang ditangkap dapat dibaca seperti respons biasa dan, pada paket Pro dan Enterprise, berubah menjadi sebuah folder permintaan sungguhan yang dapat diputar ulang, sudah terisi dengan apa yang benar-benar dikirim oleh halaman tersebut.

Inilah jalan terpendek untuk mendokumentasikan API yang hanya Anda miliki front-end-nya: tidak ada proxy yang harus dikonfigurasi, tidak ada sertifikat yang harus dipasang, tidak ada ekstensi peramban.

Membuat sesi

Sesi dibuat di mana saja dalam pohon — di akar, di dalam folder, atau di dalam folder lingkungan — dari menu konteks (“Tambah” → “Sesi perekaman”) atau dari menu “Buat”; hanya skenario yang tidak dapat memuatnya. Sesi tampil di pohon samping sebagai simpul induk: mengklik sesi itu sendiri membuka halaman konfigurasinya, dan setiap baris anaknya membuka tab tersendiri.

Konfigurasinya terdiri atas empat hal:

• Url halaman yang akan dibuka di mini browser (http://, https://, atau file://). Tombol “Mulai merekam” tetap nonaktif selama url belum valid.
• Protokol yang ditangkap: HTTP, WebSocket, GraphQL, gRPC-web — semuanya tercentang secara bawaan.
• Daftar putih: ekspresi reguler; sebuah panggilan dipertahankan jika cocok dengan setidaknya salah satunya. Jika kosong, semuanya diloloskan.
• Daftar hitam: ekspresi reguler; panggilan yang cocok dengan salah satunya dibuang. Daftar hitam selalu punya kata akhir.

Hanya pengaturan ini dan rute yang disimpulkan yang disimpan dalam berkas proyek. Panggilan yang ditangkap tetap berada di memori: panggilan itu hilang saat proyek ditutup dan tidak pernah ditulis ke disk.

Merekam

Tombol “Mulai merekam” membuka halaman di sebuah tab mini browser dan memasang perekam sebelum pemuatan pertama, sehingga panggilan yang dilakukan halaman saat mulai berjalan — termasuk koneksi WebSocket yang dibuka seketika — ikut ditangkap. Cahaya berdenyut di sekeliling lencana sesi di pohon samping, dan di sekeliling tabnya, menunjukkan bahwa perekaman sedang berjalan.

Jelajahi dan gunakan halaman seperti biasa. Dua tombol pada baris alamat mengendalikan sesi:

• Jeda perekaman membiarkan halaman tetap terbuka tetapi berhenti menyimpan panggilan — praktis untuk melewati layar yang tidak relevan.
• Hentikan perekaman melepas perekam dan menutup tab peramban. Tangkapan tetap tersedia.

Merekam selalu merupakan tindakan yang eksplisit: tab peramban yang dipulihkan saat aplikasi dibuka kembali tidak merekam apa pun.

Situs yang memerlukan lokasi Anda memintanya kepada browser, dan secara bawaan mini browser tidak mengungkapkan apa pun. Pengaturan Bagikan lokasi Anda dengan browser tertanam, di bagian Privasi pada pengaturan aplikasi dan nonaktif secara bawaan, memberikan perkiraan lokasi Anda setelah meminta persetujuan Anda — dari layanan lokasi sistem, atau jika tidak tersedia, dari perkiraan setingkat kota berdasarkan alamat IP Anda. Menonaktifkannya segera melupakan lokasi tersebut.

Tangkapan

Baris “Tangkapan” pada sesi membuka tampilan panggilan, dikelompokkan per eksekusi dari yang terlama hingga yang terbaru dan diperbarui secara langsung selama perekaman. Selama daftar digulir sampai ke bawah, daftar mengikuti panggilan terbaru; gulir ke atas untuk membaca salah satunya dan daftar tetap diam. Sebuah kolom filter mempersempit daftar; detail sebuah panggilan memakai persis tab respons yang sama dengan permintaan (isi, informasi, cookie, grafik), protokol demi protokol.

Menu konteks sebuah panggilan menawarkan “Tambahkan ke daftar putih…” atau “Tambahkan ke daftar hitam…”, dengan url panggilan itu sudah terisi sebagai pola. Anda dapat menerapkan pola baru tersebut pada panggilan yang sudah ditangkap: yang tidak lagi lolos akan dihapus, secara permanen — aplikasi meminta konfirmasi terlebih dahulu.

Jumlah panggilan yang dipertahankan per sesi dibatasi (1.000 secara bawaan, dapat diatur di pengaturan aplikasi); di atas batas itu, yang paling lama dihapus.

Menyimpulkan rute

Pada paket Pro dan Enterprise, tombol Simpulkan rute di tampilan tangkapan mengubah panggilan menjadi sebuah pohon di bawah baris “Rute” pada sesi:

• panggilan dikelompokkan per rute: segmen jalur yang berubah dari satu panggilan ke panggilan lain (/pets/1, /pets/2) menjadi parameter jalur {{petId}};
• folder mengikuti prefiks statis jalur (api › pets); panggilan gRPC-web dikelompokkan per layanan;
• setiap rute menjadi permintaan biasa — HTTP, GraphQL, gRPC-web, atau WebSocket — yang sudah terisi dari panggilan sukses terakhir (header, parameter, isi) dan dapat diputar ulang seketika;
• panggilan yang ditangkap dimasukkan ke riwayat respons setiap permintaan, dalam format yang biasa dan dalam batas retensi yang dikonfigurasi; respons yang ditampilkan secara bawaan adalah respons panggilan sukses terakhir.

Menjalankan penyimpulan lagi setelah perekaman baru bersifat menggabungkan: hanya rute baru yang ditambahkan, dan permintaan yang sudah ada — termasuk yang telah Anda ubah — tetap utuh.

Pada paket Community, perekaman dan penelusuran tangkapan tersedia sepenuhnya; tab Rute menampilkan pengingat tentang fitur Pro ini.

Dari asisten AI

Seluruh fitur ini tersedia melalui server MCP Restorm: pembuatan dan konfigurasi sesi, memulai dan menghentikan perekaman, membaca tangkapan, dan menyimpulkan rute. Dengan demikian sebuah agen dapat membuka halaman, membiarkannya berjalan, lalu menyerahkan sebuah folder permintaan yang siap pakai.