Τι εκθέτει το PDF API μας — Πιστώσεις και όρια

Οι σελίδες API τείνουν να αναπτύσσονται πιο γρήγορα από τα API. Η δική μας παραθέτει τώρα μόνο τις διαδρομές που τελειώνουν χωρίς πρόγραμμα περιήγησης: λογαριασμός, Redact και σύγκριση. Αυτό είναι εσκεμμένο. Ένα τελικό σημείο που δεν μπορεί να ολοκληρώσει τη ροή εργασίας του είναι χειρότερο από το μηδενικό τελικό σημείο.

Τι είναι ζωντανό σήμερα

• GET /v1/me — λογαριασμό, σχέδιο και ζωντανό πιστωτικό υπόλοιπο· 1 πίστωση ανά κλήση.
• POST /v1/redact-pdf — βρείτε μοτίβα, κείμενο ή εικόνες και επιστρέψτε ένα ανανεωμένο PDF με apply=1. Δωρεάν.
• POST /v1/compare-pdf — στατιστικά, αλλαγμένα μπλοκ και βασικές διαφορές μεταξύ δύο αρχείων PDF. Δωρεάν.

Και τα τρία παίρνουν ένα κλειδί φέροντος από τον λογαριασμό μου. Τα αποτελέσματα είναι JSON με σύνδεσμο λήψης που διαρκεί δύο ώρες. τα πρωτότυπα δεν τροποποιούνται ποτέ στη θέση τους.

Τι δεν υπάρχει στο API

Τι χρεώνει το API σήμερα

Υπάρχουν μόνο τρεις διαδρομές: GET /v1/me κοστίζει 1 πίστωση, ενώ POST /v1/redact-pdf και POST /v1/compare-pdf κοστίζει 5 μονάδες το καθένα. Δεν υπάρχουν χρεώσεις API συγχώνευσης ή OCR, επειδή αυτά τα εργαλεία δεν είναι τελικά σημεία API. Οι τιμές ζωντανών είναι στις Σχέδια & τιμολόγηση σελίδα.

Γιατί το E-Signer δεν είναι διαδρομή

Η υπογραφή είναι μια διπλή ροή εργασίας του προγράμματος περιήγησης: ο αποστολέας τοποθετεί πεδία στη σελίδα και ο παραλήπτης ανοίγει έναν σύνδεσμο και υπογράφει. Ένας πελάτης HTTP δεν μπορεί να δει τη διάταξη ή να χειριστεί αυτήν τη σελίδα, επομένως ένα "API e-sign" θα σταματήσει πριν ολοκληρωθεί η εργασία. Οι φάκελοι βρίσκονται στον πίνακα ελέγχου του E-Signer. το API δεν τα δημιουργεί ούτε τα υπογράφει.

Διατήρηση κλειδιών και αρχείων

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

Τι να μετρήσετε πριν την αναβάθμιση

Παρακολουθήστε τρεις αριθμούς για ένα μήνα: επιτυχημένες κλήσεις, αποτυχημένες κλήσεις και το πιστωτικό υπόλοιπο στο τέλος. Το Redact και το Compare πληρώνονται (5 μονάδες το καθένα), έτσι ώστε να εμφανίζεται ένας πολυάσχολος μήνας στο υπόλοιπο. Κόστος κλήσεων λογαριασμού 1. Εάν οι επαναλήψεις ή οι αιχμές του μήνα καταναλώνουν πιστώσεις, ένα μεγαλύτερο πρόγραμμα είναι φθηνότερο από μια αποτυχημένη παρτίδα. Επειδή οι πιστώσεις που δεν χρησιμοποιήθηκαν μεταβάλλονται, ένας ήσυχος μήνας δεν πάει χαμένος.

Το E-Signer είναι μόνο για προγράμματα περιήγησης. Κάποιος πρέπει να τοποθετήσει οπτικά τα πεδία υπογραφής του παραλήπτη και ο παραλήπτης πρέπει να ανοίξει μια σελίδα υπογραφής και να την υπογράψει. Ένας πελάτης HTTP δεν μπορεί να κάνει τίποτα από τα δύο, επομένως δεν υπάρχει διαδρομή API για τη δημιουργία, την υπογραφή, τη λίστα ή τη δημοσκόπηση φακέλων. Το ταμπλό του E-Signer παραμένει το κατάλληλο μέρος για αυτήν την εργασία.

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

Τι αγοράζει μια πίστωση

Οι πιστώσεις είναι το προπληρωμένο υπόλοιπο που συνδέεται με έναν εμπορικό λογαριασμό. Σήμερα οι μόνες διαδρομές API επί πληρωμή είναι GET /v1/me σε 1 μονάδα και Redact and Compare με 5 μονάδες το καθένα. Τα προγράμματα εξακολουθούν να περιλαμβάνουν μηνιαίο επίδομα πίστωσης και οι αχρησιμοποίητες πιστώσεις μεταβάλλονται αντί να λήγουν. Παραθέτουμε ζωντανές τιμές API στο Σχέδια & τιμολόγηση σελίδα και μην δημοσιεύετε τιμές ανά εργαλείο για διαδρομές που δεν υπάρχουν.

Κλειδιά, όρια και ασφάλεια

Τα κλειδιά API εμφανίζονται μία φορά και αποθηκεύονται μόνο ως κατακερματισμός. Ένα κλειδί που έχει ανακληθεί σταματά να λειτουργεί αμέσως. Απάντηση ορίων ρυθμού ανά κλειδί και ανά IP 429 με Retry-After, οι μεταφορτώσεις περιορίζονται ανάλογα με το μέγεθος και τον αριθμό σελίδων και ένας αποκλεισμένος ή χωρίς τίτλο λογαριασμός δεν μπορεί να χρησιμοποιήσει ζωντανό κλειδί. Το Σελίδα API τεκμηριώνει τις τρεις διαδρομές και τα πεδία αιτήματός τους.

Ξεκινώντας

Δημιουργήστε έναν λογαριασμό, ενεργοποιήστε ένα εμπορικό σχέδιο εάν χρειάζεστε κλειδιά API και, στη συνέχεια, δημιουργήστε το κλειδί στο Ο λογαριασμός μου και καλέστε GET /v1/me πρώτον. Εάν ένα εργαλείο προγράμματος περιήγησης μπορεί να κάνει τη δουλειά, χρησιμοποιήστε το εργαλείο προγράμματος περιήγησης — παραμένει δωρεάν.