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"}- 22PDF инструмента на една крайна точка
- 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 функции още тази седмица.
Създайте ключ за пясъчник за минута. Не е нужна карта.