Co ujawnia nasz interfejs API PDF — kredyty i limity
Strony API zwykle rozwijają się szybciej niż interfejsy API. Nasza lista zawiera teraz tylko trasy, które kończą się bez przeglądarki: konto, redaguj i porównaj. To jest zamierzone. Punkt końcowy, który nie może ukończyć przepływu pracy, jest gorszy niż żaden punkt końcowy.
Co jest dzisiaj na żywo
- POBIERZ /v1/me — konto, plan i aktualne saldo kredytowe; 1 kredyt na każde połączenie.
- POST /v1/redact-pdf — znajdź wzory, tekst lub obrazy i zwróć zredagowany plik PDF
apply=1. Bezpłatny. - POST /v1/compare-pdf — statystyki, zmienione bloki i kluczowe różnice między dwoma plikami PDF. Bezpłatny.
Wszyscy trzej biorą klucz na okaziciela z Mojego Konta. Wyniki to JSON z linkiem do pobrania, który jest ważny przez dwie godziny; oryginały nigdy nie są modyfikowane na miejscu.
Czego nie ma w API
Ile API pobiera dzisiaj
Istnieją tylko trzy trasy: GET /v1/me kosztuje 1 kredyt, podczas gdy POST /v1/redact-pdf i POST /v1/compare-pdf kosztuje 5 kredytów za sztukę. Nie ma żadnych opłat za scalanie ani OCR API, ponieważ te narzędzia nie są punktami końcowymi API. Ceny na żywo są na Plany i ceny strona.
Dlaczego E-Signer nie jest trasą
Podpisywanie odbywa się w przeglądarce dwukrotnie: nadawca umieszcza pola na stronie, a odbiorca otwiera link i podpisuje. Klient HTTP nie może zobaczyć układu ani obsługiwać tej strony, więc „interfejs API podpisu elektronicznego” zatrzyma się przed zakończeniem zadania. Koperty znajdują się w panelu kontrolnym E-Signer; API ich nie tworzy ani nie podpisuje.
Przechowywanie kluczy i plików
Traktuj klucz API jak hasło: jeden klucz na aplikację, obracaj go, jeśli został wklejony do publicznego repozytorium i nigdy nie umieszczaj go w JavaScript po stronie przeglądarki. Przesłane pliki są tymczasowymi kopiami roboczymi o niemożliwym do odgadnięcia identyfikatorze; nie są magazynem dokumentów. Przechowuj oryginały we własnym magazynie i traktuj odpowiedź API jako kopię pochodną. The Strona bezpieczeństwa wyświetla listę elementów sterujących i okno przechowywania.
Co zmierzyć przed aktualizacją
Śledź trzy numery przez miesiąc: udane połączenia, nieudane połączenia i saldo kredytu na koniec. Redagowanie i Porównywanie są płatne (po 5 kredytów), więc na saldzie widać pracowity miesiąc; koszt połączeń na konto 1. Jeśli ponowne próby lub skoki w szczytowym miesiącu rzeczywiście zużywają kredyty, większy plan jest tańszy niż nieudana partia. Ponieważ niewykorzystane środki przechodzą na inny, spokojny miesiąc nie będzie zmarnowany.
Aplikacja E-Signer działa wyłącznie w przeglądarce. Ktoś musi wizualnie umieścić pola podpisu odbiorcy, a odbiorca musi otworzyć stronę do podpisania i ją podpisać. Klient HTTP nie może tego zrobić, więc nie ma ścieżki API umożliwiającej tworzenie, podpisywanie, wyświetlanie list lub odpytywanie kopert. Pulpit nawigacyjny E-Signer pozostaje właściwym miejscem do tej pracy.
Ten sam test usuwa na razie scalanie, kompresję, konwersję i edytor z interfejsu API: ich przydatny przepływ pracy jest interaktywny i wymaga dużej ilości plików. Pozostają bezpłatne w przeglądarce i nie są reklamowane jako półdziałające punkty końcowe.
Co kupuje kredyt
Kredyty to przedpłacone saldo dołączone do konta komercyjnego. Obecnie jedynymi płatnymi trasami API są GET /v1/me za 1 kredyt i Redaguj i porównaj po 5 kredytów każdy. Plany nadal obejmują miesięczny limit kredytu, a niewykorzystane kredyty przechodzą na kolejny okres, a nie wygasają. Aktualne stawki API podajemy na stronie Plany i ceny i nie publikuj cen za narzędzie dla tras, które nie istnieją.
Klucze, ograniczenia i bezpieczeństwo
Klucze API są wyświetlane raz i przechowywane tylko jako skrót. Unieważniony klucz natychmiast przestaje działać. Odpowiedź na limity szybkości dla klucza i adresu IP 429 z Retry-After, przesyłane pliki są ograniczone rozmiarem i liczbą stron, a zbanowane lub nieuprawnione konto nie może używać aktywnego klucza. The strona API dokumentuje trzy trasy i ich pola żądań.
Pierwsze kroki
Utwórz konto, aktywuj plan komercyjny, jeśli potrzebujesz kluczy API, następnie utwórz klucz w Moim Koncie i zadzwoń GET /v1/me pierwszy. Jeśli narzędzie przeglądarki może wykonać to zadanie, użyj narzędzia przeglądarki — pozostaje ono bezpłatne.