Що відкриває наш PDF API — Кредити та ліміти
Сторінки API розвиваються швидше, ніж API. У нашому тепер перераховано лише маршрути, які закінчуються без браузера: обліковий запис, редагування та порівняння. Це навмисно. Кінцева точка, яка не може завершити робочий процес, гірша, ніж відсутність кінцевої точки взагалі.
Що живе сьогодні
- ОТРИМАЙТЕ /v1/me — баланс рахунку, плану та поточного кредиту; 1 кредит на дзвінок.
- POST /v1/redact-pdf — знаходити візерунки, текст або зображення та повертати відредагований PDF-файл
apply=1. безкоштовно. - POST /v1/compare-pdf — статистика, змінені блоки та ключові відмінності між двома PDF-файлами. безкоштовно.
Усі троє беруть ключ на пред’явника з «Мого облікового запису». Результати – це JSON із посиланням для завантаження, яке живе дві години; оригінали ніколи не змінюються на місці.
Чого немає в API
Скільки API стягує сьогодні
Існує всього три маршрути: GET /v1/me коштує 1 кредит, при цьому POST /v1/redact-pdf і POST /v1/compare-pdf коштують 5 кредитів кожна. Немає плати за злиття або OCR API, оскільки ці інструменти не є кінцевими точками API. Актуальні ставки діють Тарифи та ціни сторінки.
Чому E-Signer – це не маршрут
Підпис — це подвійний робочий процес браузера: відправник розміщує поля на сторінці, а одержувач відкриває посилання та підписує. Клієнт HTTP не може бачити макет або керувати цією сторінкою, тому «API електронного підпису» зупиниться до завершення роботи. Конверти живуть на інформаційній панелі E-Signer; API не створює та не підписує їх.
Зберігання ключів і файлів
Ставтеся до ключа API як до пароля: один ключ для кожної програми, змінюйте його, якщо він був вставлений у загальнодоступне сховище, і ніколи не додавайте його до JavaScript на стороні браузера. Завантажені файли є тимчасовими робочими копіями з ідентифікатором, який неможливо вгадати; вони не є сховищем документів. Зберігайте оригінали у власному сховищі та розглядайте відповідь API як похідну копію. The Сторінка безпеки містить список елементів керування та вікна збереження.
Що потрібно виміряти перед оновленням
Відстежуйте три номери протягом місяця: успішні дзвінки, невдалі дзвінки та баланс кредиту в кінці. Redact і Compare оплачуються (по 5 кредитів), тому на балансі видно насичений місяць; дзвінки за обліковим записом коштують 1. Якщо повторні спроби або стрибки в пікові місяці все-таки споживають кредити, більший план буде дешевшим, ніж невдалий пакет. Оскільки невикористані кредити повертаються, спокійний місяць не буде витрачено даремно.
E-Signer працює лише в браузері. Хтось має візуально розмістити поля для підпису одержувача, а одержувач має відкрити сторінку підпису та підписати її. HTTP-клієнт не може робити ні те, ні інше, тому немає маршруту API для створення, підпису, списку чи опитування конвертів. Інформаційна панель E-Signer залишається правильним місцем для цієї роботи.
Цей самий тест наразі видаляє з API злиття, стиснення, перетворення та редактор: їхній корисний робочий процес є інтерактивним і містить велику кількість файлів. Вони залишаються вільними у браузері, а не рекламуються як наполовину робочі кінцеві точки.
Що купує кредит
Кредити – це передплачений баланс, приєднаний до комерційного рахунку. На сьогодні єдині платні маршрути API GET /v1/me за 1 кредит і Редагування та порівняння за 5 кредитів кожен. Плани все ще включають щомісячну кредитну надбавку, а невикористані кредити переходять на інший, а не закінчуються. Ми надаємо поточні тарифи API на Тарифи та ціни і не публікуйте ціни за інструмент для маршрутів, яких не існує.
Ключі, обмеження та безпека
Ключі API відображаються один раз і зберігаються лише як хеш. Відкликаний ключ негайно припиняє працювати. Відповідь на обмеження швидкості для кожного ключа та IP-адреси 429 з Retry-After, кількість завантажень обмежена розміром і кількістю сторінок, а обліковий запис із забороною або без прав не може використовувати живий ключ. The Сторінка API документує три маршрути та їхні поля запиту.
Початок роботи
Створіть обліковий запис, активуйте комерційний план, якщо вам потрібні ключі API, потім створіть ключ у розділі «Мій обліковий запис» і зателефонуйте GET /v1/me перший. Якщо інструмент браузера може виконати роботу, використовуйте інструмент браузера — він залишається безкоштовним.