Macaaw PDF API
PDF API для стиснення, конвертації та підписання
Один REST API для 22 інструментів для PDF і електронних підписів. Кожне завдання виконується на наших серверах у Лондоні, а файли видаляються протягом 2 год.
Отримати безкоштовний ключ пісочниціЧитати документацію API
- OpenAPI 3.1
- Колекція Postman
- Безкоштовна пісочниця
- Підписані вебхуки
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 або редактор зображень у власний застосунок, поруч із вбудованим підписанням.
Як це працює
Від ключа до результату за чотири виклики
Створіть ключ
Створіть ключ пісочниці у своєму обліковому записі. Коли будете готові, перейдіть на робочий ключ.
Обліковий запис › РозробникамЗапустіть завдання
Надішліть файли й інструмент одним multipart-запитом.
POST /public/v1/tasksДізнайтеся про завершення
Підпишіться на task_completed або періодично опитуйте завдання.
webhook: task_completedЗавантажити
Отримайте результат, а потім видаліть його або дочекайтеся закінчення строку зберігання.
GET /tasks/{id}/download
Кінцеві точки
Невеликий, передбачуваний API
Базова URL-адреса https://macaaw.com/public/v1 · JSON із ключами в snake_case · Authorization: API-Key …
Завдання · інструменти для 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 уже цього тижня.
Створіть ключ пісочниці за хвилину. Картка не потрібна.