PDF API

Macaaw PDF API

PDF API для стиснення, конвертації та підписання

Один REST API для 22 інструментів для PDF і електронних підписів. Кожне завдання виконується на наших серверах у Лондоні, а файли видаляються протягом 2 год.

Отримати безкоштовний ключ пісочниціЧитати документацію API

  • OpenAPI 3.1
  • Колекція Postman
  • Безкоштовна пісочниця
  • Підписані вебхуки
Стисніть PDF одним запитом
Мова прикладу коду
curl https://macaaw.com/public/v1/tasks \
  -H "Authorization: API-Key $MACAAW_API_KEY" \
  -F "files[]=@lease.pdf" \
  -F 'data={"tool":"compress-pdf","options":{"level":"recommended"}}'

# 201 Created
{ "id": "…", "tool": "compress-pdf", "status": "task.queued" }
// Node 18+ (fetch, FormData and Blob are built in)
import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("files[]", new Blob([await readFile("lease.pdf")]), "lease.pdf");
form.append("data", JSON.stringify({ tool: "compress-pdf", options: { level: "recommended" } }));

const res = await fetch("https://macaaw.com/public/v1/tasks", {
  method: "POST",
  headers: { Authorization: `API-Key ${process.env.MACAAW_API_KEY}` },
  body: form,
});
const task = await res.json(); // { id, tool, status: "task.queued" }
# Python 3 with requests
import json, os, requests

res = requests.post(
    "https://macaaw.com/public/v1/tasks",
    headers={"Authorization": f"API-Key {os.environ['MACAAW_API_KEY']}"},
    files={"files[]": open("lease.pdf", "rb")},
    data={"data": json.dumps({"tool": "compress-pdf", "options": {"level": "recommended"}})},
)
task = res.json()  # {"id": ..., "status": "task.queued"}
  • 22інструментів для PDF на одній кінцевій точці
  • 1 викликдля передавання й запуску завдання
  • < 2 hдо видалення ваших файлів
  • 0 GBPдля пісочниці

Що можна створити

Робота з PDF, якою вашому продукту не потрібно займатися самому

  • Зменшуйте завантаження перед збереженням

    Стискайте PDF або підганяйте їх під точний розмір, щойно ваші користувачі їх завантажують.

  • Конвертуйте файли Office у PDF

    Word, Excel, PowerPoint, OpenDocument і HTML у PDF зі збереженням макета.

  • Робіть скани доступними для пошуку

    Розпізнавання тексту 32 мовами, PDF/A для архівів і таблиці просто в Excel.

  • Надсилайте угоди з власного застосунку

    Створіть документ із PDF, розмістіть поля за допомогою текстових тегів, надішліть і завантажте підписану копію.

  • Вбудуйте підписання у свій продукт

    Відкривайте сеанс підписання на своєму сайті, обмежений дозволеними вами джерелами.

  • Пакетна обробка з вебхуками

    Запускайте сотні завдань і отримуйте підписаний зворотний виклик, щойно кожне з них завершиться.

  • Ключі з обмеженнями й пакети

    Ключі з областями доступу й ротацією, пакетні завдання, перебіг у реальному часі та зображення сторінок.

  • Вбудовані редактори

    Вбудуйте редактор PDF або редактор зображень у власний застосунок, поруч із вбудованим підписанням.

Як це працює

Від ключа до результату за чотири виклики

  1. Створіть ключ

    Створіть ключ пісочниці у своєму обліковому записі. Коли будете готові, перейдіть на робочий ключ.

    Обліковий запис › Розробникам
  2. Запустіть завдання

    Надішліть файли й інструмент одним multipart-запитом.

    POST /public/v1/tasks
  3. Дізнайтеся про завершення

    Підпишіться на task_completed або періодично опитуйте завдання.

    webhook: task_completed
  4. Завантажити

    Отримайте результат, а потім видаліть його або дочекайтеся закінчення строку зберігання.

    GET /tasks/{id}/download

Кінцеві точки

Невеликий, передбачуваний API

Базова URL-адреса https://macaaw.com/public/v1 · JSON із ключами в snake_case · Authorization: API-Key …

Повний довідник API

Завдання · інструменти для PDF

  • GET/toolsУсі інструменти, які можна викликати, з їхніми параметрами
  • POST/tasksПередайте файли й запустіть інструмент одним викликом
  • GET/tasks/{id}Статус: queued, processing, completed або failed
  • GET/tasks/{id}/downloadФайл результату або ZIP
  • DELETE/tasks/{id}Видаліть файли зараз

Документи · електронні підписи

  • POST/documentsPDF разом з одержувачами й полями або текстовими тегами
  • POST/documents/{id}/sendНадсилання поштою або без листа для вбудованого підписання
  • GET/documents/{id}/detailsОдержувачі, поля й повна хронологія
  • POST/documents/{id}/sessionПосилання для підписання на вашій власній сторінці
  • GET/documents/{id}/downloadПідписаний PDF із сертифікатом

Вебхуки

  • POST/webhook-subscriptionsВиберіть тригери, як-от task_completed або document_state_changed
  • GET/webhook-eventsІсторія доставок із повторним надсиланням

Безпека

Готово до продакшену з першого дня

Ті самі правила видалення й обробка у Великій Британії, що й на вебсайті, плюс засоби контролю, яких очікує інженерна команда.

  • Ключі під вашим контролемРобочі ключі й ключі пісочниці показуються один раз і зберігаються як хеш. Будь-який ключ можна відкликати з облікового запису.
  • Підписані вебхукиКожна доставка містить ?signature= з HMAC-SHA256 тіла, створеним вашим спільним ключем.
  • Файли швидко видаляютьсяФайли завдань зберігаються 1 годину з безкоштовним обліковим записом і 2 години у Pro і Business, після чого їх уже немає. DELETE видаляє їх одразу.
  • Обробка у Великій БританіїКожне завдання виконується на наших серверах у Лондоні. Журнали запитів ніколи не зберігають вміст чи назви файлів.
  • Справедливі ліміти запитів120 нових завдань на хвилину на користувача, із Retry-After у кожній відповіді 429.
  • Безпечні повториНадішліть Idempotency-Key, і повторний запит протягом 24 год повертатиме перший результат.

Ціни

Почніть безкоштовно. Платіть у міру зростання.

Пісочниця

0 GBP

  • Усі кінцеві точки з тестовими даними
  • 10 запитів на хвилину
  • До 5 сторінок на завдання
  • Результати зі штампом «Sandbox»
  • Тестові дані видаляються через 7 днів
Отримати ключ пісочниці

Робочі ключі в Pro або Business

Від 4,99 GBPна місяць у разі річної оплати

  • Використовує місячні ліміти вашого тарифу
  • Далі кредити: від 5 GBP за 500
  • 1 кредит за сторінку OCR, 2 кредити за конвертацію Office
  • 120 нових завдань на хвилину
Порівняти тарифи

Enterprise

Ціни за обсяг

  • Ціни за обсяг на сторінки й конвертації
  • Індивідуальні ліміти за договором
  • Щорічна оплата за рахунком
  • Персональний контакт
Зв’язатися з нами

Запитання

Запитання розробників

Чи можна спробувати API безкоштовно?

Так. Будь-який користувач після входу може безкоштовно створити ключ пісочниці. Виклики в пісочниці обмежено 10 на хвилину й 5 сторінками на завдання, кожен результат має штамп «Sandbox», а тестові дані видаляються через 7 днів.

Які інструменти можна викликати?

22 інструментів, що працюють на наших серверах, — від стиснення й OCR до конвертацій Office і PDF/A, — а також електронні підписи. GET /tools повертає їх перелік із параметрами. 33 браузерних інструментів працюють у браузерах ваших користувачів, тому їх немає в API v1.

Як оплачується використання API?

Робочі ключі доступні в Pro і Business. Виклики використовують ті самі місячні ліміти, що й вебсайт; понад них застосовуються кредити. Пакети кредитів — від 5 GBP за 500 кредитів, діють 12 міс.

Чи є у вас SDK?

Документація містить готові приклади на curl, Node і Python для кожної кінцевої точки, файл OpenAPI 3.1 і колекцію Postman, тож клієнт можна згенерувати будь-якою мовою.

Що буде, якщо моя кінцева точка для вебхуків недоступна?

Ми повторюємо спробу ще тричі — через 1 хвилину, 10 хвилин і 1 годину, — а потім позначаємо доставку як невдалу. Надіслати її повторно можна з облікового запису або через API.

Випустіть функції PDF уже цього тижня.

Створіть ключ пісочниці за хвилину. Картка не потрібна.