PDF API
Ücretsiz başlayın

Macaaw PDF API

Sıkıştırma, dönüştürme ve imzalama için PDF API

20 PDF aracı ve e-imza için tek REST API. Her görev Londra’daki sunucularımızda çalışır ve dosyalar 2 saat içinde silinir.

Ücretsiz sandbox anahtarı alınAPI dokümantasyonunu okuyun

  • OpenAPI 3.1
  • Postman koleksiyonu
  • Ücretsiz sandbox
  • İmzalı webhook’lar
Tek bir istekle PDF sıkıştırın
Kod örneği dili
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"}
  • 20tek uç noktada PDF aracı
  • 1 çağrıyüklemek ve görev başlatmak için
  • < 2 hdosyalarınız silinene kadar
  • £0sandbox için

Neler kurabilirsiniz

Ürününüzün üstlenmek zorunda olmadığı PDF işleri

  • Yüklemeleri saklamadan önce küçültün

    PDF’leri kullanıcılarınız yükler yüklemez sıkıştırın veya tam belirli bir boyuta sığdırın.

  • Office dosyalarını PDF’e dönüştürün

    Word, Excel, PowerPoint, OpenDocument ve HTML’den PDF’e, düzeni bozmadan.

  • Taramaları aranabilir yapın

    27 dilde metin tanıma, arşivler için PDF/A ve doğrudan Excel’e tablolar.

  • Sözleşmeleri kendi uygulamanızdan gönderin

    Bir PDF’ten belge oluşturun, alanları metin etiketleriyle yerleştirin, gönderin ve imzalı kopyayı indirin.

  • İmzalamayı ürününüze gömün

    Sitenizin içinde, izin verdiğiniz kaynaklarla sınırlı bir imza oturumu açın.

  • Webhook’larla toplu işler çalıştırın

    Yüzlerce görev başlatın ve her biri bittiğinde imzalı bir geri çağrı alın.

Nasıl çalışır

Anahtardan sonuca dört çağrıda

  1. Anahtar oluşturun

    Hesabınızda bir sandbox anahtarı oluşturun. Hazır olduğunuzda canlı anahtara geçin.

    Hesap › Geliştirici
  2. Görev başlatın

    Dosyaları ve aracı tek bir multipart istekte gönderin.

    POST /public/v1/tasks
  3. Bittiğinde haber alın

    task_completed olayına abone olun veya görevi yoklayın.

    webhook: task_completed
  4. İndirin

    Sonucu alın, sonra silin veya süresinin dolmasına izin verin.

    GET /tasks/{id}/download

Uç noktalar

Küçük, öngörülebilir bir API

Temel URL https://macaaw.com/public/v1 · snake_case anahtarlı JSON · Authorization: API-Key …

Tam API başvurusu

Görevler · PDF araçları

  • GET/toolsÇağırabileceğiniz her araç, seçenekleriyle birlikte
  • POST/tasksDosyaları yükleyin ve bir aracı tek çağrıda başlatın
  • GET/tasks/{id}Durum: sırada, işleniyor, tamamlandı veya başarısız
  • GET/tasks/{id}/downloadSonuç dosyası veya bir ZIP
  • DELETE/tasks/{id}Dosyaları hemen silin

Belgeler · e-imzalar

  • POST/documentsBir PDF artı alıcılar ve alanlar ya da metin etiketleri
  • POST/documents/{id}/sendE-postayla veya gömülü imza için sessizce gönderin
  • GET/documents/{id}/detailsAlıcılar, alanlar ve tam zaman çizelgesi
  • POST/documents/{id}/sessionKendi sayfanız için bir imza bağlantısı
  • GET/documents/{id}/downloadİmzalı PDF ve sertifikası

Webhook’lar

  • POST/webhook-subscriptionstask_completed veya document_state_changed gibi tetikleyicileri seçin
  • GET/webhook-eventsYeniden gönderme özellikli teslimat geçmişi

Güvenlik

İlk günden üretim için tasarlandı

Web sitesiyle aynı silme kuralları ve Birleşik Krallık’ta işleme, artı bir mühendislik ekibinin beklediği denetimler.

  • Denetiminizdeki anahtarlarCanlı ve sandbox anahtarları bir kez gösterilir ve karma olarak saklanır. İstediğiniz anahtarı hesabınızdan iptal edin.
  • İmzalı webhook’larHer teslimat, ortak anahtarınızla oluşturulmuş gövdenin HMAC-SHA256 değerini içeren ?signature= taşır.
  • Hızla silinen dosyalarGörev dosyaları ücretsiz hesapta 1 saat, Pro ve Business’ta 2 saat saklanır, sonra yok olur. DELETE onları hemen kaldırır.
  • Birleşik Krallık’ta işlemeHer görev Londra’daki sunucularımızda çalışır. İstek günlükleri dosya içeriğini veya dosya adlarını asla saklamaz.
  • Adil hız sınırlarıKullanıcı başına dakikada 120 yeni görev; her 429’da Retry-After ile.
  • Güvenli yeniden denemelerBir Idempotency-Key gönderin; tekrarlanan istek 24 saat boyunca ilk sonucu döndürür.

Fiyatlandırma

Ücretsiz başlayın. Büyüdükçe ödeyin.

Sandbox

£0

  • Test verileriyle her uç nokta
  • Dakikada 10 istek
  • Görev başına en fazla 5 sayfa
  • “Sandbox” damgalı çıktılar
  • Test verileri 7 gün sonra silinir
Sandbox anahtarı alın

Canlı, Pro veya Business’ta

£4,99’danaylık, yıllık faturalanır

  • Planınızın aylık haklarını kullanır
  • Sonra krediler: 500 için £5’dan
  • OCR sayfası başına 1 kredi, Office dönüştürmesi başına 2 kredi
  • Dakikada 120 yeni görev
Planları karşılaştır

Enterprise

Hacim fiyatlandırması

  • Sayfa ve dönüştürmelerde hacim fiyatlandırması
  • Sözleşmeyle satılan özel sınırlar
  • Yıllık fatura ile ödeme
  • Adı belli bir iletişim kişisi
Bizimle konuşun

Sorular

Geliştiriciler soruyor

API’yi denemenin ücretsiz bir yolu var mı?

Evet. Oturum açmış her kullanıcı ücretsiz sandbox anahtarı oluşturabilir. Sandbox çağrıları dakikada 10 ve görev başına 5 sayfa ile sınırlıdır, her çıktı “Sandbox” damgası taşır ve test verileri 7 gün sonra silinir.

Hangi araçları çağırabilirim?

Sıkıştırma ve OCR’dan Office dönüştürmelerine ve PDF/A’ya kadar sunucularımızda çalışan 20 araç ve e-imzalar. GET /tools bunları seçenekleriyle listeler. 20 tarayıcı aracı kullanıcılarınızın tarayıcısında çalışır, bu yüzden API v1’de yoktur.

API kullanımı nasıl ücretlendirilir?

Canlı anahtarlar Pro ve Business ile gelir. Çağrılar web sitesiyle aynı aylık hakları kullanır; bunların ötesinde krediler devreye girer. Kredi paketleri 500 kredi için £5’dan başlar ve 12 ay geçerlidir.

SDK’larınız var mı?

Dokümantasyonda her uç nokta için curl, Node ve Python ile kopyala-yapıştır örnekler, bir OpenAPI 3.1 dosyası ve bir Postman koleksiyonu bulunur; böylece her dilde istemci üretebilirsiniz.

Webhook uç noktam çalışmıyorsa ne olur?

1 dakika, 10 dakika ve 1 saat sonra üç kez daha deneriz, ardından teslimatı başarısız olarak işaretleriz. Hesabınızdan veya API ile yeniden gönderebilirsiniz.

PDF özelliklerini bu hafta yayına alın.

Bir dakikada sandbox anahtarı oluşturun. Kart gerekmez.