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
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
Anahtar oluşturun
Hesabınızda bir sandbox anahtarı oluşturun. Hazır olduğunuzda canlı anahtara geçin.
Hesap › GeliştiriciGörev başlatın
Dosyaları ve aracı tek bir multipart istekte gönderin.
POST /public/v1/tasksBittiğinde haber alın
task_completed olayına abone olun veya görevi yoklayın.
webhook: task_completedİ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 …
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
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
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
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.