Kayıt oturumları

Bir kayıt oturumu, siz bir web sayfasını kullanırken sayfayı izler ve yaptığı her API çağrısını not eder: REST, GraphQL, gRPC-web ve WebSocket. Yakalanan çağrılar sıradan yanıtlar gibi incelenir ve Pro ile Enterprise planlarında, sayfanın gerçekten gönderdiği verilerle önceden doldurulmuş gerçek, yeniden oynatılabilir isteklerden oluşan bir klasöre dönüşür.

Elinizde yalnızca ön yüzü bulunan bir API’yi belgelemenin en kısa yoludur: yapılandırılacak proxy, kurulacak sertifika, yüklenecek tarayıcı uzantısı yok.

Oturum oluşturma

Bir oturum, ağacın herhangi bir yerinde — kökte, bir klasörde veya bir ortam klasöründe — bağlam menüsünden (“Ekle” → “Kayıt oturumu”) veya “Oluştur” menüsünden oluşturulur; yalnızca bir senaryo oturum içeremez. Kenar çubuğunda bir üst düğüm olarak görünür: oturumun kendisine tıklamak yapılandırma sayfasını açar, alt satırlarının her biri ise kendi sekmesini açar.

Yapılandırma dört öğeden oluşur:

• Mini tarayıcıda açılacak sayfanın url’si (http://, https:// veya file://). “Kaydı başlat” düğmesi, url geçerli olmadığı sürece devre dışı kalır.
• Yakalanacak protokoller: HTTP, WebSocket, GraphQL, gRPC-web — varsayılan olarak hepsi işaretlidir.
• Beyaz liste: düzenli ifadeler; bir çağrı, bunlardan en az biriyle eşleşiyorsa tutulur. Boş bırakıldığında her şeyi geçirir.
• Kara liste: düzenli ifadeler; bunlardan biriyle eşleşen çağrı atılır. Son söz her zaman kara listenindir.

Proje dosyasına yalnızca bu ayarlar ve çıkarılan rotalar kaydedilir. Yakalanan çağrılar ise bellekte kalır: proje kapatıldığında silinir ve hiçbir zaman diske yazılmaz.

Kayıt

“Kaydı başlat” düğmesi sayfayı bir mini tarayıcı sekmesinde açar ve kaydediciyi ilk yüklemeden önce bağlar; böylece sayfanın açılış sırasında yaptığı çağrılar — hemen açılan bir WebSocket bağlantısı dahil — yakalanır. Kenar çubuğunda oturumun rozetinin ve sekmesinin çevresinde titreşen bir ışık halkası, kaydın sürdüğünü gösterir.

Sayfada normal şekilde gezinin ve kullanın. Adres satırındaki iki düğme oturumu denetler:

• Kaydı duraklat, sayfayı açık tutar ancak çağrıları saklamayı bırakır — ilginizi çekmeyen bir ekranı geçmek için kullanışlıdır.
• Kaydı durdur, kaydediciyi ayırır ve tarayıcı sekmesini kapatır. Yakalamalar kullanılabilir kalır.

Kayıt her zaman açık bir eylemdir: uygulama yeniden açıldığında geri yüklenen bir tarayıcı sekmesi hiçbir şey kaydetmez.

Konumunuza ihtiyaç duyan siteler bunu tarayıcıdan ister ve mini tarayıcı varsayılan olarak hiçbir şey vermez. Uygulama ayarlarının Gizlilik bölümündeki, varsayılan olarak kapalı Konumunuzu yerleşik tarayıcıyla paylaşın ayarı, onayınızı istedikten sonra yaklaşık konumunuzu sağlar — sistemin konum hizmetinden, o yoksa IP adresinize dayalı şehir düzeyinde bir tahminden. Kapatıldığında konum hemen unutulur.

Yakalamalar

Oturumun “Yakalamalar” satırı, çalıştırmaya göre en eskiden en yeniye gruplanmış ve kayıt sırasında canlı güncellenen çağrılar görünümünü açar. Liste en alta kaydırılmış durumdayken en yeni çağrıları izler; birini okumak için yukarı kaydırdığınızda liste yerinde kalır. Bir filtre alanı listeyi daraltır; bir çağrının ayrıntısı, isteklerin yanıt sekmelerini (gövde, bilgiler, çerezler, grafik) protokol protokol birebir yeniden kullanır.

Bir çağrının bağlam menüsü, url’si desen olarak önceden doldurulmuş biçimde onu beyaz listeye veya kara listeye eklemeyi önerir. Yeni deseni önceden yakalanmış çağrılara da uygulayabilirsiniz: artık geçemeyenler kalıcı olarak silinir — uygulama onay ister.

Oturum başına tutulan çağrı sayısı sınırlıdır (varsayılan 1.000, uygulama ayarlarından değiştirilebilir); sınır aşıldığında en eskiler silinir.

Rotaları çıkarma

Pro ve Enterprise planlarında, yakalamalar görünümündeki Rotaları çıkar düğmesi çağrıları oturumun “Rotalar” satırının altında bir ağaca dönüştürür:

• çağrılar rotaya göre gruplanır: bir çağrıdan diğerine değişen bir yol parçası (/pets/1, /pets/2) bir {{petId}} yol parametresi olur;
• klasörler yolların sabit ön eklerini izler (api › pets); gRPC-web çağrıları servise göre yerleştirilir;
• her rota, son başarılı çağrıdan (başlıklar, parametreler, gövde) önceden doldurulmuş ve hemen yeniden oynatılabilir sıradan bir istek olur — HTTP, GraphQL, gRPC-web veya WebSocket;
• yakalanan çağrılar, her isteğin yanıt geçmişine olağan biçimde ve yapılandırılan saklama sınırı dahilinde aktarılır; varsayılan olarak gösterilen yanıt, son başarılı çağrının yanıtıdır.

Yeni kayıtlardan sonra çıkarmayı yeniden çalıştırmak birleştirir: yalnızca yeni rotalar eklenir; mevcut istekler — değiştirdikleriniz dahil — olduğu gibi kalır.

Community planında kayıt ve yakalamaları inceleme tamamen kullanılabilir; Rotalar sekmesi Pro özelliğine ilişkin bir hatırlatma gösterir.

Bir yapay zekâ asistanından

Özelliğin tamamı Restorm MCP sunucusu aracılığıyla sunulur: oturum oluşturma ve yapılandırma, kaydı başlatma ve durdurma, yakalamaları okuma ve rotaları çıkarma. Böylece bir ajan bir sayfayı açabilir, çalışmasına izin verebilir, ardından kullanıma hazır bir istek klasörü teslim edebilir.