Ce expune API-ul nostru PDF - Credite și limite
Paginile API tind să crească mai repede decât API-urile. Al nostru listează acum doar rutele care se termină fără browser: cont, Redact și Comparare. Asta este deliberat. Un punct final care nu își poate finaliza fluxul de lucru este mai rău decât niciun punct final.
Ce este în direct astăzi
- GET /v1/me — soldul contului, al planului și al creditului în direct; 1 credit pe apel.
- POST /v1/redact-pdf — găsiți modele, text sau imagini și returnați un PDF redactat cu
apply=1. Gratuit. - POST /v1/compare-pdf — statistici, blocuri modificate și diferențe cheie între două PDF-uri. Gratuit.
Toți trei iau o cheie purtător din Contul meu. Rezultatele sunt JSON cu un link de descărcare care durează două ore; originalele nu sunt niciodată modificate la locul lor.
Ce nu este în API
Ce percepe API-ul astăzi
Există doar trei rute: GET /v1/me costă 1 credit, în timp ce POST /v1/redact-pdf şi POST /v1/compare-pdf costa 5 credite fiecare. Nu există taxe de îmbinare sau OCR API, deoarece aceste instrumente nu sunt puncte finale API. Tarifele live sunt pe Planuri și prețuri pagina.
De ce E-Signer nu este o rută
Semnarea este un flux de lucru din browser de două ori: expeditorul plasează câmpuri pe pagină, iar destinatarul deschide un link și semnează. Un client HTTP nu poate vedea aspectul sau nu poate opera pagina respectivă, așa că un „API de semnare electronică” s-ar opri înainte ca lucrarea să fie terminată. Plicurile se află în tabloul de bord E-Signer; API-ul nu le creează și nu le semnează.
Reținerea cheilor și a fișierelor
Tratați o cheie API ca o parolă: o cheie per aplicație, rotiți-o dacă a fost lipită într-un depozit public și nu o puneți niciodată în JavaScript din partea browserului. Fișierele încărcate sunt copii temporare de lucru cu un id de neghicit; nu sunt un depozit de documente. Păstrați originalele în propriul spațiu de stocare și tratați răspunsul API ca pe o copie derivată. The Pagina de securitate listează controalele și fereastra de reținere.
Ce să măsori înainte de a face upgrade
Urmăriți trei numere timp de o lună: apeluri reușite, apeluri eșuate și soldul creditului la sfârșit. Redact și Compare sunt plătite (5 credite fiecare), așa că o lună aglomerată este vizibilă în sold; apelurile la cont costă 1. Dacă reîncercările sau vârfurile în lunile de vârf consumă credite, un plan mai mare este mai ieftin decât un lot eșuat. Deoarece creditele neutilizate se transferă, o lună liniștită nu este irosită.
E-Signer este doar pentru browser. Cineva trebuie să plaseze vizual câmpurile de semnătură ale destinatarului, iar destinatarul trebuie să deschidă o pagină de semnare și să o semneze. Un client HTTP nu poate face niciuna dintre ele, așa că nu există nicio rută API pentru a crea, semna, enumera sau sonda plicuri. Tabloul de bord E-Signer rămâne locul potrivit pentru această activitate.
Același test elimină deocamdată îmbinarea, comprimarea, conversia și editorul din API: fluxul lor de lucru util este interactiv și aglomerat de fișiere. Acestea rămân gratuite în browser, mai degrabă decât să fie promovate ca puncte finale care funcționează pe jumătate.
Ce cumpără un credit
Creditele sunt soldul plătit în avans atașat unui cont comercial. Astăzi, singurele rute API plătite sunt GET /v1/me la 1 credit și Redact and Compare la 5 credite fiecare. Planurile includ în continuare o alocație de credit lunară, iar creditele neutilizate sunt transferate în loc să expire. Enumerăm ratele API live pe Planuri și prețuri pagina și nu publicați prețuri per instrument pentru rute care nu există.
Chei, limite și siguranță
Cheile API sunt afișate o singură dată și stocate doar ca hash. O cheie revocată nu mai funcționează imediat. Răspuns limitele de rată per-cheie și per-IP 429 cu Retry-After, încărcările sunt limitate în funcție de dimensiune și de numărul de pagini, iar un cont interzis sau fără drept nu poate folosi o cheie live. The Pagina API documentează cele trei rute și câmpurile de solicitare ale acestora.
Pentru început
Creați un cont, activați un plan comercial dacă aveți nevoie de chei API, apoi creați cheia în Contul meu și sunați GET /v1/me mai întâi. Dacă un instrument de browser poate face treaba, utilizați instrumentul de browser - rămâne gratuit.