Περίοδοι καταγραφής

Μια περίοδος καταγραφής παρακολουθεί μια ιστοσελίδα ενώ τη χρησιμοποιείτε και σημειώνει κάθε κλήση API που πραγματοποιεί: REST, GraphQL, gRPC-web και WebSocket. Οι καταγεγραμμένες κλήσεις διαβάζονται όπως οι συνηθισμένες απαντήσεις και, στα προγράμματα Pro και Enterprise, μετατρέπονται σε έναν φάκελο με πραγματικά αιτήματα που επαναλαμβάνονται, προσυμπληρωμένα με όσα έστειλε πράγματι η σελίδα.

Είναι ο συντομότερος δρόμος για να τεκμηριώσετε ένα API από το οποίο διαθέτετε μόνο το front-end: κανένας διαμεσολαβητής προς ρύθμιση, κανένα πιστοποιητικό προς εγκατάσταση, καμία επέκταση περιηγητή.

Δημιουργία μιας περιόδου

Μια περίοδος δημιουργείται οπουδήποτε στο δέντρο — στη ρίζα, σε έναν φάκελο ή σε έναν φάκελο περιβάλλοντος — από το μενού περιβάλλοντος («Προσθήκη» → «Περίοδος καταγραφής») ή από το μενού «Δημιουργία»· μόνο ένα σενάριο δεν μπορεί να περιέχει μία. Εμφανίζεται στην πλαϊνή μπάρα ως γονικός κόμβος: κάνοντας κλικ στην ίδια την περίοδο ανοίγει η σελίδα ρύθμισής της, ενώ κάθε θυγατρική γραμμή της ανοίγει τη δική της καρτέλα.

Η ρύθμιση συνοψίζεται σε τέσσερα στοιχεία:

• Το url της σελίδας που θα ανοίξει στον μίνι περιηγητή (http://, https:// ή file://). Το κουμπί Έναρξη καταγραφής παραμένει ανενεργό όσο το url δεν είναι έγκυρο.
• Τα πρωτόκολλα προς καταγραφή: HTTP, WebSocket, GraphQL, gRPC-web — όλα επιλεγμένα από προεπιλογή.
• Η λευκή λίστα: κανονικές εκφράσεις· μια κλήση διατηρείται αν αντιστοιχεί σε τουλάχιστον μία από αυτές. Κενή, αφήνει τα πάντα να περάσουν.
• Η μαύρη λίστα: κανονικές εκφράσεις· μια κλήση που αντιστοιχεί σε κάποια από αυτές απορρίπτεται. Η μαύρη λίστα έχει πάντα τον τελευταίο λόγο.

Μόνο αυτές οι ρυθμίσεις και οι συναχθείσες διαδρομές αποθηκεύονται στο αρχείο του έργου. Οι καταγεγραμμένες κλήσεις μένουν στη μνήμη: εξαφανίζονται με το κλείσιμο του έργου και δεν γράφονται ποτέ στον δίσκο.

Καταγραφή

Το κουμπί Έναρξη καταγραφής ανοίγει τη σελίδα σε μια καρτέλα μίνι περιηγητή και συνδέει τον καταγραφέα πριν από την πρώτη φόρτωση, ώστε να καταγράφονται και οι κλήσεις που πραγματοποιεί η σελίδα κατά την εκκίνησή της — συμπεριλαμβανομένης μιας σύνδεσης WebSocket που ανοίγει αμέσως. Ένα παλλόμενο φωτοστέφανο γύρω από το σήμα της περιόδου στην πλαϊνή μπάρα, και γύρω από την καρτέλα της, δείχνει ότι η καταγραφή εκτελείται.

Περιηγηθείτε και χρησιμοποιήστε τη σελίδα κανονικά. Δύο κουμπιά στη γραμμή διευθύνσεων ελέγχουν την περίοδο:

• Παύση της καταγραφής κρατά τη σελίδα ανοιχτή αλλά δεν αποθηκεύει πλέον τις κλήσεις — πρακτικό για να προσπεράσετε μια οθόνη χωρίς ενδιαφέρον.
• Διακοπή της καταγραφής αποσυνδέει τον καταγραφέα και κλείνει την καρτέλα του περιηγητή. Οι καταγραφές παραμένουν διαθέσιμες.

Η καταγραφή είναι πάντα μια ρητή ενέργεια: μια καρτέλα περιηγητή που επανέρχεται κατά το νέο άνοιγμα της εφαρμογής δεν καταγράφει τίποτα.

Οι ιστότοποι που χρειάζονται τη θέση σας τη ζητούν από τον περιηγητή, και από προεπιλογή ο μίνι περιηγητής δεν αποκαλύπτει τίποτα. Η ρύθμιση Κοινή χρήση της θέσης σας με το ενσωματωμένο πρόγραμμα περιήγησης, στην ενότητα Απόρρητο των ρυθμίσεων της εφαρμογής και απενεργοποιημένη από προεπιλογή, παρέχει την κατά προσέγγιση θέση σας αφού ζητήσει τη συγκατάθεσή σας — από την υπηρεσία εντοπισμού θέσης του συστήματος, αλλιώς από μια εκτίμηση σε επίπεδο πόλης με βάση τη διεύθυνση IP σας. Η απενεργοποίησή της ξεχνά αμέσως τη θέση.

Οι καταγραφές

Η γραμμή «Καταγραφές» της περιόδου ανοίγει την προβολή των κλήσεων, ομαδοποιημένων ανά εκτέλεση από την παλαιότερη προς τη νεότερη και ενημερωμένων ζωντανά κατά την καταγραφή. Όσο η λίστα είναι κυλισμένη ως το τέλος, ακολουθεί τις νεότερες κλήσεις· κυλίστε προς τα πάνω για να διαβάσετε μία και η λίστα μένει ακίνητη. Ένα πεδίο φίλτρου περιορίζει τη λίστα· η λεπτομέρεια μιας κλήσης επαναχρησιμοποιεί ακριβώς τις καρτέλες απάντησης των αιτημάτων (σώμα, πληροφορίες, cookies, γράφημα), πρωτόκολλο προς πρωτόκολλο.

Το μενού περιβάλλοντος μιας κλήσης προτείνει την προσθήκη της στη λευκή ή στη μαύρη λίστα, με το url της προσυμπληρωμένο ως μοτίβο. Μπορείτε να εφαρμόσετε το νέο μοτίβο στις κλήσεις που έχουν ήδη καταγραφεί: όσες δεν περνούν πλέον διαγράφονται, οριστικά — η εφαρμογή ζητά επιβεβαίωση.

Ο αριθμός των κλήσεων που διατηρούνται ανά περίοδο έχει ανώτατο όριο (1.000 από προεπιλογή, ρυθμιζόμενο στις ρυθμίσεις της εφαρμογής)· πέρα από αυτό, οι παλαιότερες διαγράφονται.

Συναγωγή των διαδρομών

Στα προγράμματα Pro και Enterprise, το κουμπί Συναγωγή διαδρομών της προβολής των καταγραφών μετατρέπει τις κλήσεις σε ένα δέντρο κάτω από τη γραμμή «Διαδρομές» της περιόδου:

• οι κλήσεις ομαδοποιούνται ανά διαδρομή: ένα τμήμα της διαδρομής που αλλάζει από κλήση σε κλήση (/pets/1, /pets/2) γίνεται παράμετρος διαδρομής {{petId}}·
• οι φάκελοι ακολουθούν τα στατικά προθέματα των διαδρομών (api › pets)· οι κλήσεις gRPC-web ταξινομούνται ανά υπηρεσία·
• κάθε διαδρομή γίνεται ένα συνηθισμένο αίτημα — HTTP, GraphQL, gRPC-web ή WebSocket — προσυμπληρωμένο από την τελευταία επιτυχημένη κλήση (κεφαλίδες, παράμετροι, σώμα) και άμεσα επαναλήψιμο·
• οι καταγεγραμμένες κλήσεις καταχωρίζονται στο ιστορικό απαντήσεων κάθε αιτήματος, στη συνήθη μορφή και εντός του ρυθμισμένου ορίου διατήρησης· η απάντηση που εμφανίζεται από προεπιλογή είναι εκείνη της τελευταίας επιτυχημένης κλήσης.

Η επανάληψη της συναγωγής μετά από νέες καταγραφές συγχωνεύει: προστίθενται μόνο οι νέες διαδρομές, ενώ τα υπάρχοντα αιτήματα — συμπεριλαμβανομένων εκείνων που έχετε τροποποιήσει — παραμένουν ανέπαφα.

Στο πρόγραμμα Community, η καταγραφή και η ανάγνωση των καταγραφών είναι πλήρως διαθέσιμες· η καρτέλα Διαδρομές εμφανίζει μια υπενθύμιση της λειτουργίας Pro.

Από έναν βοηθό AI

Ολόκληρη η λειτουργία εκτίθεται μέσω του διακομιστή MCP του Restorm: δημιουργία και ρύθμιση μιας περιόδου, έναρξη και διακοπή της καταγραφής, ανάγνωση των καταγραφών και συναγωγή των διαδρομών. Ένας πράκτορας μπορεί έτσι να ανοίξει μια σελίδα, να την αφήσει να λειτουργήσει και στη συνέχεια να παραδώσει έναν φάκελο με αιτήματα έτοιμα προς χρήση.