Hvad vores PDF API afslører – kreditter og grænser
API-sider har en tendens til at vokse hurtigere end API'er. Vores viser nu kun de ruter, der slutter uden en browser: konto, Redact og Sammenlign. Det er bevidst. Et endepunkt, der ikke kan fuldføre sin arbejdsgang, er værre end intet endepunkt overhovedet.
Hvad er live i dag
- FÅ /v1/me — konto, plan og levende kreditsaldo; 1 kredit pr. opkald.
- POST /v1/redact-pdf — find mønstre, tekst eller billeder, og returner en redigeret PDF med
apply=1. Gratis. - POST /v1/sammenlign-pdf — statistik, ændrede blokke og vigtige forskelle mellem to PDF'er. Gratis.
Alle tre tager en ihændehavernøgle fra Min konto. Resultaterne er JSON med et downloadlink, der lever i to timer; originalerne bliver aldrig ændret på plads.
Hvad er der ikke i API'en
Hvad API'en opkræver i dag
Der findes kun tre ruter: GET /v1/me koster 1 kredit, mens POST /v1/redact-pdf og POST /v1/compare-pdf koster 5 kreditter hver. Der er ingen fusions- eller OCR API-afgifter, fordi disse værktøjer ikke er API-endepunkter. Live-priserne er på Planer og priser side.
Hvorfor E-Signer ikke er en rute
Signering er en browserarbejdsgang to gange: Afsenderen placerer felter på siden, og modtageren åbner et link og underskriver. En HTTP-klient kan ikke se layoutet eller betjene den side, så en "e-sign API" ville stoppe, før jobbet er færdigt. Konvolutterne findes i E-Signer-dashboardet; API'en opretter eller underskriver dem ikke.
Nøgler og filopbevaring
Behandl en API-nøgle som en adgangskode: én nøgle pr. applikation, roter den, hvis den er blevet indsat i et offentligt lager, og læg den aldrig i browser-side JavaScript. Uploadede filer er midlertidige arbejdskopier med et id, der ikke kan gættes; de er ikke et dokumentlager. Opbevar originalerne i dit eget lager, og behandl API-svaret som den afledte kopi. Den Sikkerhedsside viser kontrolelementerne og opbevaringsvinduet.
Hvad skal man måle før opgradering
Spor tre numre i en måned: vellykkede opkald, mislykkede opkald og kreditsaldoen i slutningen. Redact og Compare betales (5 credits hver), så en travl måned er synlig i balancen; kontoopkald koster 1. Hvis genforsøg eller spidsbelastninger i spidsbelastningsmåneden bruger kreditter, er en større plan billigere end en mislykket batch. Fordi ubrugte kreditter ruller over, er en stille måned ikke spildt.
E-Signer er kun for browser. Nogen skal placere modtagerens signaturfelter visuelt, og modtageren skal åbne en signaturside og underskrive den. En HTTP-klient kan hverken gøre det, så der er ingen API-rute til at oprette, underskrive, liste eller polle konvolutter. E-Signer-dashboardet forbliver det rigtige sted til det arbejde.
Den samme test fjerner fletning, komprimering, konverter og editoren fra API'et indtil videre: deres nyttige arbejdsgang er interaktiv og filtung. De forbliver gratis i browseren i stedet for at blive annonceret som halvt fungerende slutpunkter.
Hvad en kredit køber
Kreditter er den forudbetalte saldo knyttet til en kommerciel konto. I dag er de eneste betalte API-ruter GET /v1/me på 1 point og Redact and Compare på 5 point hver. Planer inkluderer stadig en månedlig kreditgodtgørelse, og ubrugte kreditter ruller over i stedet for at udløbe. Vi viser live API-priser på Planer og priser side og offentliggør ikke priser pr. værktøj for ruter, der ikke eksisterer.
Nøgler, grænser og sikkerhed
API-nøgler vises én gang og gemmes kun som en hash. En tilbagekaldt nøgle holder op med at virke med det samme. Takstgrænser pr. nøgle og pr. IP svarer 429 med Retry-After, uploads er begrænset af størrelse og sideantal, og en forbudt eller uberettiget konto kan ikke bruge en live-nøgle. Den API side dokumenterer de tre ruter og deres anmodningsfelter.
Kom godt i gang
Opret en konto, aktiver en kommerciel plan, hvis du har brug for API-nøgler, opret derefter nøglen i Min konto og ring GET /v1/me først. Hvis et browserværktøj kan gøre jobbet, skal du bruge browserværktøjet - det forbliver gratis.