Co naše PDF API odhaluje — kredity a limity
Stránky API mají tendenci růst rychleji než API. Naše nyní uvádí pouze trasy, které končí bez prohlížeče: účet, Redact a Compare. To je záměrné. Koncový bod, který nemůže dokončit svůj pracovní postup, je horší než žádný koncový bod.
Co je dnes živé
- GET /v1/me — zůstatek účtu, plánu a aktuálního kreditu; 1 kredit na hovor.
- POST /v1/redact-pdf — najít vzory, text nebo obrázky a vrátit upravené PDF s
apply=1. Uvolnit. - POST /v1/compare-pdf — statistiky, změněné bloky a klíčové rozdíly mezi dvěma PDF. Uvolnit.
Všichni tři si vezmou klíč na doručitele z mého účtu. Výsledky jsou JSON s odkazem ke stažení, který trvá dvě hodiny; originály se nikdy neupravují na místě.
Co není v API
Co si API účtuje dnes
Existují pouze tři cesty: GET /v1/me stojí 1 kredit, přitom POST /v1/redact-pdf a POST /v1/compare-pdf každý stojí 5 kreditů. Neexistují žádné poplatky za sloučení nebo OCR API, protože tyto nástroje nejsou koncovými body API. Živé sazby jsou na Plány a ceny stránku.
Proč E-Signer není trasa
Podepisování je pracovní postup prohlížeče dvakrát: odesílatel umístí pole na stránku a příjemce otevře odkaz a podepíše se. HTTP klient nevidí rozvržení ani nemůže ovládat tuto stránku, takže „e-sign API“ by se zastavilo před dokončením úlohy. Obálky jsou umístěny v přístrojové desce E-Signer; API je nevytváří ani nepodepisuje.
Klíče a uchování souborů
Zacházejte s klíčem API jako s heslem: jeden klíč na aplikaci, otočte jej, pokud byl vložen do veřejného úložiště, a nikdy jej nevkládejte do JavaScriptu na straně prohlížeče. Nahrané soubory jsou dočasné pracovní kopie s neuhodnutelným ID; nejsou úložištěm dokumentů. Originály si ponechte ve svém vlastním úložišti a s odpovědí API zacházejte jako s odvozenou kopií. The Stránka zabezpečení uvádí ovládací prvky a okno uchování.
Co měřit před upgradem
Měsíčně sledujte tři čísla: úspěšné hovory, neúspěšné hovory a zůstatek kreditu na konci. Redact a Compare jsou placené (každý 5 kreditů), takže na zůstatku je vidět rušný měsíc; hovory na účet stojí 1. Pokud opakované pokusy nebo špičky ve špičce spotřebovávají kredity, je větší plán levnější než neúspěšná dávka. Protože se nevyužité kredity převalují, není klidný měsíc promarněný.
E-Signer je pouze prohlížeč. Někdo musí umístit podpisová pole příjemce vizuálně a příjemce musí otevřít podpisovou stránku a podepsat ji. HTTP klient neumí ani jedno, takže neexistuje žádná cesta API k vytváření, podepisování, vypisování nebo dotazování obálek. Přístrojová deska E-Signer zůstává tím správným místem pro tuto práci.
Stejný test prozatím odstraňuje sloučení, komprimaci, převod a editor z API: jejich užitečný pracovní postup je interaktivní a náročný na soubory. Zůstávají zdarma v prohlížeči, než aby byly inzerovány jako napůl fungující koncové body.
Co kredit kupuje
Kredity jsou předplacený zůstatek připojený ke komerčnímu účtu. Dnes jsou jediné placené cesty API GET /v1/me za 1 kredit a Redact and Compare po 5 kreditech. Plány stále zahrnují měsíční kredit a nevyužité kredity se převalují, místo aby vypršely. Uvádíme aktuální sazby API na Plány a ceny a nezveřejňovat ceny za nástroj pro trasy, které neexistují.
Klíče, limity a bezpečnost
Klíče API jsou zobrazeny jednou a uloženy pouze jako hash. Odvolaný klíč přestane okamžitě fungovat. Odpověď na omezení rychlosti na klíč a na IP 429 s Retry-After, nahrávání je omezeno velikostí a počtem stránek a zakázaný nebo neoprávněný účet nemůže používat živý klíč. The stránka API dokumentuje tři trasy a jejich pole požadavků.
Začínáme
Vytvořte si účet, aktivujte komerční plán, pokud potřebujete klíče API, poté vytvořte klíč v části Můj účet a zavolejte GET /v1/me první. Pokud tuto práci zvládne nástroj prohlížeče, použijte nástroj prohlížeče – zůstane zdarma.