Cosa espone la nostra API PDF: crediti e limiti
Le pagine API tendono a crescere più velocemente delle API. Il nostro ora elenca solo i percorsi che terminano senza browser: account, Redact e Confronta. Questo è intenzionale. Un endpoint che non riesce a completare il proprio flusso di lavoro è peggiore di nessun endpoint.
Cosa c'è in diretta oggi
- OTTIENI /v1/me — conto, piano e saldo del credito in tempo reale; 1 credito per chiamata.
- POST /v1/redact-pdf - trova modelli, testo o immagini e restituisci un PDF redatto con
apply=1. Gratuito. - POST /v1/confronta-pdf - statistiche, blocchi modificati e differenze chiave tra due PDF. Gratuito.
Tutti e tre prendono una chiave al portatore da Il mio account. I risultati sono JSON con un collegamento per il download che dura due ore; gli originali non vengono mai modificati sul posto.
Cosa non è presente nell'API
Quanto addebita l'API oggi
Esistono solo tre percorsi: GET /v1/me costa 1 credito, mentre POST /v1/redact-pdf e POST /v1/compare-pdf costano 5 crediti ciascuno. Non sono previsti costi per l'unione o l'API OCR perché questi strumenti non sono endpoint API. Le tariffe in tempo reale sono sul Piani e prezzi pagina.
Perché E-Signer non è un percorso
La firma è un flusso di lavoro del browser doppio: il mittente inserisce i campi nella pagina e il destinatario apre un collegamento e firma. Un client HTTP non può vedere il layout o gestire quella pagina, quindi una "API e-sign" si fermerebbe prima che il lavoro sia finito. Le buste risiedono nella dashboard di E-Signer; l'API non li crea né li firma.
Chiavi e conservazione dei file
Tratta una chiave API come una password: una chiave per applicazione, ruotala se è stata incollata in un repository pubblico e non inserirla mai nel JavaScript lato browser. I file caricati sono copie di lavoro temporanee con un ID non identificabile; non sono un archivio di documenti. Conserva gli originali nel tuo spazio di archiviazione e tratta la risposta API come copia derivata. Il Pagina di sicurezza elenca i controlli e la finestra di conservazione.
Cosa misurare prima dell'aggiornamento
Tieni traccia di tre numeri per un mese: chiamate riuscite, chiamate non riuscite e saldo del credito alla fine. Redazione e Confronto vengono pagati (5 crediti ciascuno), quindi nel saldo è visibile un mese intenso; costo delle chiamate sull'account 1. Se i nuovi tentativi o i picchi dei mesi di punta consumano crediti, un piano più ampio è più economico di un batch non riuscito. Poiché i crediti inutilizzati si rinnovano, un mese tranquillo non è sprecato.
E-Signer è disponibile solo per il browser. Qualcuno deve posizionare visivamente i campi della firma del destinatario e il destinatario deve aprire una pagina di firma e firmarla. Un client HTTP non può fare nessuna delle due cose, quindi non esiste un percorso API per creare, firmare, elencare o interrogare le buste. La dashboard di E-Signer rimane il posto giusto per questo lavoro.
Lo stesso test rimuove per ora l'unione, la compressione, la conversione e l'editor dall'API: il loro utile flusso di lavoro è interattivo e ricco di file. Rimangono gratuiti nel browser anziché essere pubblicizzati come endpoint semi-funzionanti.
Cosa compra un credito
I crediti sono il saldo prepagato allegato a un conto commerciale. Oggi le uniche rotte API a pagamento sono GET /v1/me a 1 credito e Redatta e confronta a 5 crediti ciascuno. I piani includono ancora un credito mensile e i crediti non utilizzati vengono rinnovati invece di scadere. Elenchiamo le tariffe API in tempo reale su Piani e prezzi pagina e non pubblicare prezzi per strumento per percorsi che non esistono.
Chiavi, limiti e sicurezza
Le chiavi API vengono visualizzate una volta e archiviate solo come hash. Una chiave revocata smette di funzionare immediatamente. Risposta ai limiti di velocità per chiave e per IP 429 con Retry-After, i caricamenti sono limitati dalle dimensioni e dal numero di pagine e un account escluso o senza diritto non può utilizzare una chiave live. Il Pagina dell'API documenta i tre percorsi ed i relativi campi di richiesta.
Iniziare
Crea un account, attiva un piano commerciale se hai bisogno di chiavi API, quindi crea la chiave in Il mio account e chiama GET /v1/me prima. Se uno strumento del browser può svolgere il lavoro, utilizza lo strumento del browser: rimane gratuito.