Wat onze PDF API blootlegt: kredieten en limieten
API-pagina's groeien doorgaans sneller dan API's. Die van ons toont nu alleen de routes die eindigen zonder browser: account, Redacteren en Vergelijken. Dat is opzettelijk. Een eindpunt dat zijn workflow niet kan voltooien, is erger dan helemaal geen eindpunt.
Wat is live vandaag
- KRIJG /v1/me — rekening-, plan- en live-tegoedsaldo; 1 tegoed per gesprek.
- POST /v1/redact-pdf - vind patronen, tekst of afbeeldingen en stuur een geredigeerde PDF terug
apply=1. Vrij. - POST /v1/vergelijk-pdf — statistieken, gewijzigde blokken en belangrijkste verschillen tussen twee pdf's. Vrij.
Alle drie nemen ze een sleutel aan toonder uit Mijn Account. Resultaten zijn JSON met een downloadlink die twee uur geldig is; originelen worden nooit ter plekke gewijzigd.
Wat staat er niet in de API
Wat de API vandaag in rekening brengt
Er bestaan slechts drie routes: GET /v1/me kost 1 credit, terwijl POST /v1/redact-pdf en POST /v1/compare-pdf kosten elk 5 credits. Er zijn geen samenvoeg- of OCR-API-kosten omdat deze tools geen API-eindpunten zijn. De live tarieven staan op de Abonnementen en prijzen pagina.
Waarom E-Signer geen route is
Ondertekenen is een tweeledige browserworkflow: de afzender plaatst velden op de pagina en de ontvanger opent een link en ondertekent. Een HTTP-client kan de lay-out niet zien of die pagina bedienen, dus een “e-sign API” zou stoppen voordat de taak is voltooid. Enveloppen staan live in het E-Signer-dashboard; de API maakt of ondertekent ze niet.
Sleutels en bestandsbehoud
Behandel een API-sleutel als een wachtwoord: één sleutel per applicatie, roteer deze als deze in een openbare opslagplaats is geplakt en plaats hem nooit in JavaScript aan de browserzijde. Geüploade bestanden zijn tijdelijke werkkopieën met een onraadbare id; ze zijn geen documentopslag. Bewaar de originelen in uw eigen opslag en behandel het API-antwoord als de afgeleide kopie. De Beveiligingspagina vermeldt de bedieningselementen en het bewaarvenster.
Wat u moet meten voordat u een upgrade uitvoert
Houd een maand lang drie nummers bij: succesvolle oproepen, mislukte oproepen en het tegoed aan het einde. Redacteren en Vergelijken worden betaald (elk 5 credits), dus een drukke maand is zichtbaar in de balans; Accountoproepen kosten 1. Als nieuwe pogingen of piekmaandpieken wel credits verbruiken, is een groter abonnement goedkoper dan een mislukte batch. Omdat ongebruikte credits doorrollen, is een rustige maand niet verloren.
E-Signer werkt alleen in een browser. Iemand moet de handtekeningvelden van de ontvanger visueel plaatsen en de ontvanger moet een ondertekeningspagina openen en ondertekenen. Een HTTP-client kan geen van beide, dus er is geen API-route om enveloppen te maken, te ondertekenen, in een lijst op te nemen of te pollen. Voor dat werk blijft het E-Signer dashboard de juiste plek.
Dezelfde test verwijdert voorlopig het samenvoegen, comprimeren, converteren en de editor uit de API: hun nuttige workflow is interactief en bevat veel bestanden. Ze blijven gratis in de browser en worden niet geadverteerd als halfwerkende eindpunten.
Wat een krediet koopt
Credits zijn het prepaid-saldo dat aan een commerciële account is gekoppeld. Tegenwoordig zijn dit de enige betaalde API-routes GET /v1/me voor 1 credit en Redacteren en vergelijken voor elk 5 credits. Plannen omvatten nog steeds een maandelijks kredietbedrag, en ongebruikte kredieten worden overgedragen in plaats van verlopen. We vermelden live API-tarieven op de Abonnementen en prijzen pagina en publiceer geen prijzen per tool voor routes die niet bestaan.
Sleutels, limieten en veiligheid
API-sleutels worden één keer getoond en alleen als hash opgeslagen. Een ingetrokken sleutel werkt onmiddellijk niet meer. Tarieflimieten per sleutel en per IP beantwoorden 429 met Retry-After, worden uploads beperkt op grootte en aantal pagina's, en een verbannen account of account zonder rechten kan geen live sleutel gebruiken. De API-pagina documenteert de drie routes en hun aanvraagvelden.
Aan de slag
Maak een account aan, activeer een Commercieel abonnement als u API-sleutels nodig heeft, maak vervolgens de sleutel aan in Mijn Account en bel GET /v1/me eerst. Als een browsertool het werk kan doen, gebruik dan de browsertool; deze blijft gratis.