Macaaw PDF API
PDF API للضغط والتحويل والتوقيع
واجهة REST API واحدة لـ20 أداة PDF والتوقيعات الإلكترونية. تعمل كل مهمة على خوادمنا في لندن وتُحذف الملفات خلال 2 ساعة.
احصل على مفتاح وضع اختبار مجانياقرأ وثائق API
- OpenAPI 3.1
- مجموعة Postman
- وضع اختبار مجاني
- webhooks موقّعة
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"}- 20أدوات PDF عبر نقطة نهاية واحدة
- طلب واحدلرفع الملفات وبدء مهمة
- < 2 hحتى تُحذف ملفاتك
- 0 UK£لوضع الاختبار
ما يمكنك بناؤه
مهام PDF التي لا ينبغي لمنتجك أن يتولاها
صغّر الملفات المرفوعة قبل تخزينها
اضغط ملفات PDF، أو لائمها مع حجم دقيق، لحظة رفع مستخدميك لها.
حوّل ملفات Office إلى PDF
من Word وExcel وPowerPoint وOpenDocument وHTML إلى PDF، بتخطيطات ثابتة.
اجعل الممسوحات قابلة للبحث
تعرّف على النصوص بـ27 لغة، وPDF/A للأرشيف، وجداول مباشرة إلى Excel.
أرسل الاتفاقيات من تطبيقك
أنشئ مستندًا من ملف PDF، وضع الحقول بوسوم نصية، وأرسله ونزّل النسخة الموقّعة.
ضمّن التوقيع في منتجك
افتح جلسة توقيع داخل موقعك، مقيّدة بالمصادر التي تسمح بها.
شغّل دفعات باستخدام webhooks
ابدأ مئات المهام واحصل على استدعاء مرتجع موقّع عند انتهاء كل منها.
كيف يعمل
من المفتاح إلى النتيجة في أربعة استدعاءات
أنشئ مفتاحًا
أنشئ مفتاح وضع اختبار في حسابك. وبدّل إلى مفتاح فعلي عندما تكون جاهزًا.
الحساب › المطورابدأ مهمة
أرسل الملفات والأداة في طلب multipart واحد.
POST /public/v1/tasksاعرف متى تنتهي
اشترك في task_completed، أو استعلم عن المهمة دوريًا.
webhook: task_completedنزّل
اجلب النتيجة، ثم احذفها أو دعها تنتهِ صلاحيتها.
GET /tasks/{id}/download
نقاط النهاية
واجهة صغيرة يمكن التنبؤ بسلوكها
عنوان URL الأساسي https://macaaw.com/public/v1 · JSON بمفاتيح snake_case · Authorization: API-Key …
المهام · أدوات PDF
- GET
/toolsكل أداة يمكنك استدعاؤها، مع خياراتها - POST
/tasksارفع الملفات وابدأ أداة بطلب واحد - GET
/tasks/{id}الحالة: في الانتظار، أو قيد المعالجة، أو مكتملة، أو فاشلة - GET
/tasks/{id}/downloadملف النتيجة، أو ZIP - DELETE
/tasks/{id}احذف الملفات الآن
المستندات · التوقيعات الإلكترونية
- POST
/documentsملف PDF مع المستلمين والحقول، أو وسوم نصية - POST
/documents/{id}/sendأرسل بالبريد الإلكتروني، أو بصمت للتوقيع المضمَّن - GET
/documents/{id}/detailsالمستلمون والحقول والجدول الزمني الكامل - POST
/documents/{id}/sessionرابط توقيع لصفحتك الخاصة - GET
/documents/{id}/downloadملف PDF الموقّع مع شهادته
Webhooks
- POST
/webhook-subscriptionsاختر المشغّلات مثل task_completed أو document_state_changed - GET
/webhook-eventsسجل التسليم، مع إعادة الإرسال
الأمان
مصمَّم للإنتاج منذ اليوم الأول
قواعد الحذف نفسها والمعالجة في المملكة المتحدة كما في الموقع، إضافةً إلى الضوابط التي يتوقعها فريق هندسي.
- مفاتيح تتحكم بهامفاتيح فعلية ومفاتيح وضع اختبار، تُعرض مرة واحدة وتُخزَّن كتجزئة. يمكنك سحب أي مفتاح من حسابك.
- webhooks موقّعةيحمل كل تسليم ?signature= مع HMAC-SHA256 لمحتوى الطلب، مُنشأ بمفتاحك المشترك.
- ملفات تُحذف بسرعةتُحفظ ملفات المهام ساعة واحدة في الحساب المجاني وساعتين في Pro وBusiness، ثم تزول. يزيلها DELETE فورًا.
- معالجة في المملكة المتحدةتعمل كل مهمة على خوادمنا في لندن. ولا تخزّن سجلات الطلبات محتوى الملفات ولا أسماءها أبدًا.
- حدود معدل عادلة120 مهمة جديدة في الدقيقة لكل مستخدم، مع Retry-After في كل استجابة 429.
- إعادة محاولة آمنةأرسل Idempotency-Key وسيعيد الطلب المكرر النتيجة الأولى لمدة 24 ساعة.
الأسعار
ابدأ مجانًا. وادفع كلما نموت.
وضع الاختبار
0 UK£
- كل نقطة نهاية، مع بيانات اختبار
- 10 طلب في الدقيقة
- حتى 5 صفحة لكل مهمة
- نواتج مختومة بعبارة «Sandbox»
- تُحذف بيانات الاختبار بعد 7 يومًا
فعلي، مع Pro أو Business
ابتداءً من 4.99 UK£شهريًا، تُدفع سنويًا
- يستخدم الحصص الشهرية لخطتك
- ثم الأرصدة: ابتداءً من 5 UK£ مقابل 500
- رصيد واحد لكل صفحة OCR، ورصيدان لكل تحويل Office
- 120 مهمة جديدة في الدقيقة
Enterprise
تسعير بالحجم
- تسعير بالحجم للصفحات والتحويلات
- حدود مخصصة، تُباع بعقد
- فوترة سنوية بفاتورة
- جهة اتصال مخصصة
أسئلة
أسئلة المطورين
هل توجد طريقة مجانية لتجربة API؟
نعم. يستطيع أي مستخدم مسجَّل الدخول إنشاء مفتاح وضع اختبار مجانًا. تقتصر استدعاءات وضع الاختبار على 10 في الدقيقة و5 صفحة لكل مهمة، ويُختم كل ناتج بعبارة «Sandbox»، وتُحذف بيانات الاختبار بعد 7 يومًا.
ما الأدوات التي يمكنني استدعاؤها؟
أدوات الخادم الـ20 التي تعمل على خوادمنا، من الضغط وOCR إلى تحويلات Office وPDF/A، إضافةً إلى التوقيعات الإلكترونية. يسردها GET /tools مع خياراتها. أما أدوات المتصفح الـ20 فتعمل في متصفحات مستخدميك، لذا ليست في API v1.
كيف يُحتسب استخدام API؟
تأتي المفاتيح الفعلية مع Pro وBusiness. تستخدم الاستدعاءات الحصص الشهرية نفسها المتاحة على الموقع؛ وما زاد عليها تُطبَّق عليه الأرصدة. تبدأ حزم الأرصدة من 5 UK£ مقابل 500 رصيد وتبقى صالحة 12 أشهر.
هل لديكم SDKs؟
تحتوي الوثائق على نماذج جاهزة للنسخ واللصق بـ curl وNode وPython لكل نقطة نهاية، وملف OpenAPI 3.1 ومجموعة Postman، فتستطيع توليد عميل بأي لغة.
ماذا يحدث إن كانت نقطة نهاية webhook لدي متوقفة؟
نعيد المحاولة ثلاث مرات أخرى، بعد دقيقة و10 دقائق وساعة، ثم نعلّم التسليم بأنه فشل. يمكنك إعادة إرساله من حسابك أو عبر API.
أطلق ميزات PDF هذا الأسبوع.
أنشئ مفتاح وضع اختبار في دقيقة. لا حاجة إلى بطاقة.