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"}
  • 22PDF инструмента на една крайна точка
  • 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 функции още тази седмица.

Създайте ключ за пясъчник за минута. Не е нужна карта.