Amit PDF API-nk felfed – kreditek és korlátok

Az API-oldalak általában gyorsabban nőnek, mint az API-k. A miénk már csak azokat az útvonalakat sorolja fel, amelyek böngésző nélkül fejeződnek be: fiók, Redact és Compare. Ez szándékos. Az a végpont, amely nem tudja befejezni a munkafolyamatát, rosszabb, mint a végpont hiánya.

Mi van ma élőben

• Szerezze be a /v1/me — számla, terv és élő hitelegyenleg; 1 kredit hívásonként.
• POST /v1/redact-pdf — kereshet mintákat, szöveget vagy képeket, és visszaküldheti a szerkesztett PDF-et apply=1. Ingyenes.
• POST /v1/compare-pdf — statisztikák, megváltozott blokkok és a két PDF közötti legfontosabb különbségek. Ingyenes.

Mindhárman vesznek egy hordozókulcsot a fiókomból. Az eredmények: JSON egy letöltési linkkel, amely két órán keresztül él; az eredetiket soha nem módosítják a helyükön.

Ami nincs az API-ban

Mit számít fel ma az API

Csak három útvonal létezik: GET /v1/me 1 kreditbe kerül, míg POST /v1/redact-pdf és POST /v1/compare-pdf egyenként 5 kreditbe kerül. Nincsenek összevonási vagy OCR API-díjak, mivel ezek az eszközök nem API-végpontok. Az élő árak a Tervek és árak oldalon.

Miért nem útvonal az E-Signer?

Az aláírás kétszeri böngésző munkafolyamat: a feladó mezőket helyez el az oldalon, a címzett pedig megnyit egy hivatkozást és aláír. A HTTP-kliensek nem láthatják az oldal elrendezését és nem kezelhetik az oldalt, ezért az „e-sign API” leáll a feladat befejezése előtt. A borítékok az E-Signer műszerfalán jelennek meg; az API nem hozza létre és nem írja alá őket.

Kulcsok és fájlmegőrzés

Az API-kulcsot úgy kell kezelni, mint egy jelszót: alkalmazásonként egy kulcsot, forgassa el, ha nyilvános lerakatba illeszti be, és soha ne helyezze el a böngészőoldali JavaScriptbe. A feltöltött fájlok ideiglenes munkapéldányok kitalálhatatlan azonosítóval; ezek nem irattár. Tartsa az eredetiket a saját tárhelyén, és kezelje az API-választ származtatott másolatként. A Biztonsági oldal felsorolja a vezérlőket és a megőrzési ablakot.

Mit kell mérni a frissítés előtt

Kövesse nyomon három számot egy hónapon keresztül: a sikeres hívásokat, a sikertelen hívásokat és a végén lévő hitelegyenleget. A Redact és az Compare fizetett (mindegyik 5 kredit), így egy mozgalmas hónap látható az egyenlegben; a számlahívások költsége 1. Ha az újrapróbálkozások vagy a csúcshónapi kiugrások kreditet fogyasztanak, egy nagyobb csomag olcsóbb, mint egy sikertelen köteg. Mivel a fel nem használt kreditek felborulnak, egy nyugodt hónap nem megy kárba.

Az E-Signer csak böngészőben használható. Valakinek vizuálisan el kell helyeznie a címzett aláírási mezőit, a címzettnek pedig meg kell nyitnia egy aláíró oldalt, és alá kell írnia. Egy HTTP-kliens egyikre sem képes, így nincs API-útvonal borítékok létrehozására, aláírására, listázására vagy lekérdezésére. Az E-Signer műszerfal továbbra is a megfelelő hely ehhez a munkához.

Ugyanez a teszt egyelőre eltávolítja az API-ból az egyesítést, tömörítést, konvertálást és a szerkesztőt: hasznos munkafolyamatuk interaktív és fájlnehéz. A böngészőben ingyenesek maradnak, nem pedig félig működő végpontként hirdetik őket.

Mit vásárol egy hitel

A jóváírások a Kereskedelmi számlához kapcsolt előre kifizetett egyenleg. Ma az egyetlen fizetős API-útvonal GET /v1/me 1 kredittel és Redact and Compare 5 kredittel. A tervek továbbra is tartalmazzák a havi hitelkeretet, és a fel nem használt kreditek a lejárat helyett átkerülnek. Az élő API-díjakat a Tervek és árak oldalon, és ne tegyen közzé eszközenkénti árakat a nem létező útvonalakhoz.

Kulcsok, korlátok és biztonság

Az API-kulcsok egyszer jelennek meg, és csak hash-ként tárolódnak. A visszavont kulcs azonnal leáll. Válasz kulcsonkénti és IP-címenkénti sebességkorlátozásra 429 -val Retry-After, a feltöltéseket a méret és az oldalszám korlátozza, és a tiltott vagy jogosulatlan fiók nem használhat élő kulcsot. A API oldal dokumentálja a három útvonalat és azok kérési mezőit.

Kezdő lépések

Hozzon létre egy fiókot, aktiváljon egy kereskedelmi csomagot, ha API-kulcsokra van szüksége, majd hozza létre a kulcsot a Saját fiókban, és hívja GET /v1/me először. Ha egy böngészőeszköz képes elvégezni a feladatot, használja a böngészőeszközt – az ingyenes marad.