Χωρίς σύνδεση: πώς ο ανώνυμος περιορισμός ρυθμού κρατά ένα δωρεάν εργαλείο δωρεάν

Το PDF123 διατηρεί διαδρομή μεταφόρτωσης και λήψης χωρίς λογαριασμό. Οι ίδιες λειτουργίες βρίσκονται και κάτω από το /api/v1/, ώστε ένα σενάριο να τις καλεί χωρίς άνθρωπο να πατά «Επεξεργασία». Η ανώνυμη χρήση δεν απαιτεί κλειδί API. Τα όρια ρυθμού κρατούν αυτή την επιφάνεια από το να γίνει απεριόριστος δωρεάν ξενιστής.

Η ανώνυμη διαδρομή είναι η προεπιλογή

Ρίξτε ένα αρχείο σε μια σελίδα εργαλείου όπως η Συμπίεση ή η Συγχώνευση και εκτελέστε το. Το ανώνυμο REST κάτω από το /api/v1/ λειτουργεί με τον ίδιο τρόπο για τα εργαλεία του καταλόγου. Τα σημεία API κάτω από τα /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ και /api/v1/filter/ είναι τα ανώνυμα προθέματα εργαλείων· κάθε εργαλείο του καταλόγου στην πύλη αντιστοιχεί σε αυτές τις διαδρομές.

Η σύνδεση υπάρχει για να δημιουργείτε προσωπικό κλειδί API για αυτοματοποίηση, όχι για να γίνει το κουμπί «Επεξεργασία» τείχος πληρωμής. Η φόρμα στον φυλλομετρητή και το συμβόλαιο HTTP μένουν ευθυγραμμισμένα: το μπλοκ «Κλήση από κώδικα» κάθε σελίδας εργαλείου χτίζει ένα curl από τα ίδια πεδία που στέλνει η φόρμα.

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

Τι λένε οι κεφαλίδες

Κάθε απάντηση του φιλοξενούμενου API ανακοινώνει τον προϋπολογισμό (υλοποιημένο στον pdfx-server):

• X-RateLimit-Limit: το ανώτατο όριο περιόδου που ανακοινώνεται για αυτή την απάντηση
• X-RateLimit-Remaining: ο προϋπολογισμός που απομένει στην τρέχουσα περίοδο
• X-RateLimit-Reset: δείκτης επαναφοράς του παραθύρου (διαβάστε την τιμή· μην υποθέσετε ημερολογιακή ημέρα)

Σε HTTP 429, το Retry-After λέει σε έναν ευγενικό πελάτη πότε να ξαναδοκιμάσει. Οι αποτυχίες ποσόστωσης χρησιμοποιούν τον δομημένο κωδικό rate_limited όπως περιγράφεται στα Σφάλματα για προγραμματιστές, με το ίδιο σχήμα application/problem+json όπως άλλες αποτυχίες του API. Ένα σενάριο μπορεί να διακλαδωθεί με βάση τον κωδικό χωρίς να αποσπάσει σελίδα σφάλματος HTML.

Τα αριθμητικά όρια μπορούν να αλλάξουν με τις ρυθμίσεις ανάπτυξης. Οι κεφαλίδες μιας δεδομένης απάντησης είναι η πηγή αλήθειας, όχι ένα στιγμιότυπο από άρθρο. Ένας πελάτης που κωδικοποιεί σταθερά έναν ημερήσιο αριθμό από αυτό το άρθρο θα κάνει λάθος την επόμενη φορά που η λειτουργία θα συντονίσει ξανά την περίοδο. Προτιμήστε να διαβάζετε το X-RateLimit-Remaining μετά από κάθε κλήση και να υποχωρείτε όταν πλησιάζει το μηδέν.

Γιατί ένα δωρεάν εργαλείο βάζει όρια

Χωρίς όρια, τα ανώνυμα σημεία API γίνονται το αγρόκτημα παρτίδων κάποιου άλλου. Τα όρια κρατούν τις μεμονωμένες εργασίες εφικτές, ενώ τα βαρύτερα ή ιδιωτικά φορτία μετακινούνται σε κλειδιά ή σε αυτο-φιλοξενία.

Τα όρια προστατεύουν επίσης την κοινή CPU για λειτουργίες που είναι πραγματικά ακριβές: μεγάλες συγχωνεύσεις, OCR που επιστρέφει Markdown από σαρώσεις (text/markdown, όχι PDF με στρώμα κειμένου) και πολυβηματικές εκτελέσεις POST /api/v1/pipeline. Η επιλογή του προϊόντος είναι «ανώνυμο και πεπερασμένο», όχι «ανώνυμο και απεριόριστο».

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

Τα κλειδιά αλλάζουν ταυτότητα, όχι τον κατάλογο

Δημιουργήστε κλειδί από τη σελίδα Προγραμματιστές όταν χρειάζεστε σταθερή ταυτότητα καλούντα, επαναλήψεις με Idempotency-Key που δεν πρέπει να εκτελέσουν δύο φορές την εργασία, ή αυτο-φιλοξενούμενο διακομιστή με σταθερό καθολικό κλειδί (SECURITY_CUSTOMGLOBALAPIKEY στο μηχάνημά σας). Το OpenAPI παραμένει στο /v1/openapi.json σε όποια βάση κι αν χτυπάτε.

Το MCP στο /mcp ακολουθεί τον ίδιο κατάλογο και την ίδια ιστορία κλειδιών για πελάτες αυτοματοποίησης. Οι λειτουργίες μένουν ίδιες είτε ο καλών είναι ανώνυμος είτε έχει κλειδί. Αυτό που αλλάζει είναι η πιστοποίηση και η ποσόστωση.

Για τις τέσσερις λαβές στην ίδια λειτουργία (φυλλομετρητής, curl, MCP, CLI), δείτε το Ίδια λειτουργία, τέσσερις πελάτες. Για να μεταφέρετε ολόκληρη την επιφάνεια στο δίκτυό σας όταν τα όρια ή η διατήρηση δεν αρκούν, δείτε το Τι σας αγοράζει στην πραγματικότητα η αυτο-φιλοξενία.