PDF API
مفت شروع کریں

Macaaw PDF API

کمپریس، کنورٹ اور دستخط کے لیے PDF API

20 PDF ٹولز اور ای دستخط کے لیے ایک REST API۔ ہر ٹاسک لندن میں ہمارے سرورز پر چلتا ہے اور فائلیں 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"}
  • 20ایک اینڈ پوائنٹ پر PDF ٹولز
  • 1 کالاپ لوڈ کرنے اور ٹاسک شروع کرنے کے لیے
  • < 2 hآپ کی فائلیں حذف ہونے تک
  • £0سینڈ باکس کے لیے

آپ کیا بنا سکتے ہیں

وہ PDF کام جو آپ کی پروڈکٹ کو اپنے ذمے نہیں لینے چاہییں

  • اسٹور کرنے سے پہلے اپ لوڈز چھوٹی کریں

    PDFs کو کمپریس کریں، یا انہیں عین سائز کے اندر لائیں، جیسے ہی آپ کے صارفین انہیں اپ لوڈ کریں۔

  • آفس فائلوں کو PDF میں بدلیں

    Word، Excel، PowerPoint، OpenDocument اور HTML سے PDF، ایسے لے آؤٹ کے ساتھ جو برقرار رہتے ہیں۔

  • اسکینز کو قابل تلاش بنائیں

    27 زبانوں میں ٹیکسٹ ریکگنیشن، آرکائیوز کے لیے PDF/A، اور ٹیبلز سیدھے Excel میں۔

  • اپنی ایپ سے معاہدے بھیجیں

    PDF سے دستاویز بنائیں، ٹیکسٹ ٹیگز سے فیلڈز لگائیں، بھیجیں اور دستخط شدہ کاپی ڈاؤن لوڈ کریں۔

  • دستخط کو اپنی پروڈکٹ میں ایمبیڈ کریں

    اپنی سائٹ کے اندر دستخط کا سیشن کھولیں، جو آپ کے اجازت یافتہ اوریجنز تک محدود ہو۔

  • ویب ہکس کے ساتھ بیچز چلائیں

    سینکڑوں ٹاسکس شروع کریں اور ہر ایک کے مکمل ہونے پر دستخط شدہ کال بیک پائیں۔

یہ کیسے کام کرتا ہے

کی سے نتیجے تک چار کالز میں

  1. کی بنائیں

    اپنے اکاؤنٹ میں سینڈ باکس کی بنائیں۔ تیار ہونے پر لائیو کی پر جائیں۔

    اکاؤنٹ › ڈویلپر
  2. ٹاسک شروع کریں

    فائلیں اور ٹول ایک ہی ملٹی پارٹ ریکوئسٹ میں بھیجیں۔

    POST /public/v1/tasks
  3. مکمل ہونے کی خبر پائیں

    task_completed کو سبسکرائب کریں، یا ٹاسک کو پول کریں۔

    webhook: task_completed
  4. ڈاؤن لوڈ

    نتیجہ حاصل کریں، پھر اسے حذف کریں یا ختم ہونے دیں۔

    GET /tasks/{id}/download

اینڈ پوائنٹس

ایک چھوٹی، قابل پیش گوئی API

بیس URL https://macaaw.com/public/v1 · snake_case کیز کے ساتھ JSON · 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/documentsایک PDF، وصول کنندگان اور فیلڈز کے ساتھ، یا ٹیکسٹ ٹیگز
  • POST/documents/{id}/sendای میل سے بھیجیں، یا ایمبیڈ شدہ دستخط کے لیے خاموشی سے
  • GET/documents/{id}/detailsوصول کنندگان، فیلڈز اور مکمل ٹائم لائن
  • POST/documents/{id}/sessionآپ کے اپنے صفحے کے لیے دستخط کا لنک
  • GET/documents/{id}/downloadدستخط شدہ PDF اس کے سرٹیفکیٹ کے ساتھ

ویب ہکس

  • POST/webhook-subscriptionstask_completed یا document_state_changed جیسے ٹرگرز منتخب کریں
  • GET/webhook-eventsڈیلیوری کی ہسٹری، دوبارہ بھیجنے کے ساتھ

سیکیورٹی

پہلے دن سے پروڈکشن کے لیے بنایا گیا

ویب سائٹ جیسے ہی حذف کرنے کے اصول اور UK میں پروسیسنگ، ساتھ وہ کنٹرولز جن کی انجینئرنگ ٹیم توقع کرتی ہے۔

  • کیز جو آپ کے قابو میں ہیںلائیو اور سینڈ باکس کیز، ایک بار دکھائی جاتی ہیں اور ہیش کے طور پر محفوظ ہوتی ہیں۔ اپنے اکاؤنٹ سے کوئی بھی کی منسوخ کریں۔
  • دستخط شدہ ویب ہکسہر ڈیلیوری میں ?signature= ہوتا ہے، جو آپ کی مشترکہ کی سے بنا باڈی کا HMAC-SHA256 ہے۔
  • فائلیں جلدی حذفٹاسک کی فائلیں مفت اکاؤنٹ پر 1 گھنٹہ اور Pro و Business پر 2 گھنٹے رکھی جاتی ہیں، پھر ختم ہو جاتی ہیں۔ DELETE انہیں فوراً ہٹا دیتا ہے۔
  • UK میں پروسیسنگہر ٹاسک لندن میں ہمارے سرورز پر چلتا ہے۔ ریکوئسٹ لاگز فائلوں کا مواد یا فائلوں کے نام کبھی ذخیرہ نہیں کرتے۔
  • مناسب ریٹ حدودفی صارف فی منٹ 120 نئے ٹاسکس، ہر 429 پر Retry-After کے ساتھ۔
  • محفوظ ری ٹرائیزIdempotency-Key بھیجیں اور دہرائی گئی ریکوئسٹ 24 گھنٹوں تک پہلا نتیجہ ہی لوٹاتی ہے۔

قیمتیں

مفت شروع کریں۔ بڑھنے کے ساتھ ادائیگی کریں۔

سینڈ باکس

£0

  • ہر اینڈ پوائنٹ، ٹیسٹ ڈیٹا کے ساتھ
  • فی منٹ 10 ریکوئسٹس
  • فی ٹاسک 5 صفحات تک
  • آؤٹ پٹس پر «Sandbox» کی مہر
  • ٹیسٹ ڈیٹا 7 دن بعد حذف
سینڈ باکس کی حاصل کریں

لائیو، Pro یا Business پر

£4.99 سےماہانہ، سالانہ بل کے ساتھ

  • آپ کے پلان کا ماہانہ کوٹا استعمال کرتا ہے
  • پھر کریڈٹس: 500 کے لیے £5 سے
  • فی OCR صفحہ 1 کریڈٹ، فی آفس کنورژن 2 کریڈٹس
  • فی منٹ 120 نئے ٹاسکس
پلانز کا موازنہ کریں

Enterprise

والیوم قیمتیں

  • صفحات اور کنورژنز پر والیوم قیمتیں
  • حسب ضرورت حدود، معاہدے کے ذریعے
  • سالانہ انوائس بلنگ
  • نامزد رابطہ
ہم سے بات کریں

سوالات

ڈویلپرز پوچھتے ہیں

کیا API آزمانے کا کوئی مفت طریقہ ہے؟

جی ہاں۔ سائن ان کیا ہوا کوئی بھی صارف مفت سینڈ باکس کی بنا سکتا ہے۔ سینڈ باکس کالز فی منٹ 10 اور فی ٹاسک 5 صفحات تک محدود ہیں، ہر آؤٹ پٹ پر «Sandbox» کی مہر لگتی ہے، اور ٹیسٹ ڈیٹا 7 دن بعد حذف ہو جاتا ہے۔

میں کون سے ٹولز کال کر سکتا ہوں؟

وہ 20 ٹولز جو ہمارے سرورز پر چلتے ہیں، کمپریس اور OCR سے لے کر آفس کنورژنز اور PDF/A تک، ساتھ ای دستخط۔ GET /tools انہیں ان کے اختیارات کے ساتھ دکھاتا ہے۔ 20 براؤزر ٹولز آپ کے صارفین کے براؤزرز میں چلتے ہیں، اس لیے وہ API v1 میں نہیں ہیں۔

API کے استعمال کی رقم کیسے لی جاتی ہے؟

لائیو کیز Pro اور Business کے ساتھ آتی ہیں۔ کالز ویب سائٹ جیسا ہی ماہانہ کوٹا استعمال کرتی ہیں؛ اس سے آگے کریڈٹس لاگو ہوتے ہیں۔ کریڈٹ پیکس 500 کریڈٹس کے لیے £5 سے شروع ہوتے ہیں اور 12 ماہ تک چلتے ہیں۔

کیا آپ کے پاس SDKs ہیں؟

دستاویزات میں ہر اینڈ پوائنٹ کے لیے curl، Node اور Python میں کاپی اور پیسٹ کرنے کے نمونے، ایک OpenAPI 3.1 فائل اور ایک Postman کلیکشن موجود ہے، تاکہ آپ کسی بھی زبان میں کلائنٹ بنا سکیں۔

اگر میرا ویب ہک اینڈ پوائنٹ بند ہو تو کیا ہوگا؟

ہم 1 منٹ، 10 منٹ اور 1 گھنٹے بعد تین بار مزید کوشش کرتے ہیں، پھر ڈیلیوری کو ناکام نشان زد کر دیتے ہیں۔ آپ اسے اپنے اکاؤنٹ سے یا API کے ذریعے دوبارہ بھیج سکتے ہیں۔

اسی ہفتے PDF فیچرز لانچ کریں۔

ایک منٹ میں سینڈ باکس کی بنائیں۔ کارڈ کی ضرورت نہیں۔