PDF API
मुफ़्त शुरू करें

Macaaw PDF API

PDF को कंप्रेस, कन्वर्ट और साइन करने के लिए 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 के वे काम जो आपके प्रोडक्ट को खुद नहीं संभालने चाहिए

  • स्टोर करने से पहले अपलोड छोटे करें

    PDF को कंप्रेस करें, या उन्हें ठीक तय साइज़ के भीतर लाएँ, जैसे ही आपके उपयोगकर्ता उन्हें अपलोड करें।

  • Office फ़ाइलों को PDF में बदलें

    Word, Excel, PowerPoint, OpenDocument और HTML से PDF, ऐसे लेआउट के साथ जो टिके रहते हैं।

  • स्कैन को खोजने योग्य बनाएँ

    27 भाषाओं में टेक्स्ट पहचान, आर्काइव के लिए PDF/A, और टेबल सीधे Excel में।

  • अपने ऐप से एग्रीमेंट भेजें

    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 · 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 व बिज़नेस पर 2 घंटे रखी जाती हैं, फिर वे चली जाती हैं। DELETE उन्हें तुरंत हटा देता है।
  • UK में प्रोसेसिंगहर काम लंदन में हमारे सर्वर पर चलता है। रिक्वेस्ट लॉग में फ़ाइल की सामग्री या फ़ाइल के नाम कभी स्टोर नहीं होते।
  • उचित रेट लिमिटप्रति उपयोगकर्ता प्रति मिनट 120 नए काम, हर 429 पर Retry-After के साथ।
  • सुरक्षित रीट्राईIdempotency-Key भेजें और दोहराया गया अनुरोध 24 घंटों तक पहला नतीजा लौटाता है।

कीमत

मुफ़्त शुरू करें। बढ़ने के साथ भुगतान करें।

सैंडबॉक्स

£0

  • हर एंडपॉइंट, टेस्ट डेटा के साथ
  • प्रति मिनट 10 अनुरोध
  • प्रति काम 5 पेज तक
  • आउटपुट पर “Sandbox” की मुहर
  • टेस्ट डेटा 7 दिन बाद डिलीट
सैंडबॉक्स कुंजी पाएँ

लाइव, Pro या बिज़नेस पर

£4.99 सेप्रति माह, सालाना बिल

  • आपके प्लान की मासिक सीमाएँ इस्तेमाल करता है
  • फिर क्रेडिट: 500 के लिए £5 से
  • प्रति OCR पेज 1 क्रेडिट, प्रति Office कन्वर्ज़न 2 क्रेडिट
  • प्रति मिनट 120 नए काम
प्लान की तुलना करें

Enterprise

वॉल्यूम कीमत

  • पेज और कन्वर्ज़न पर वॉल्यूम कीमत
  • कस्टम सीमाएँ, अनुबंध के ज़रिए
  • सालाना इनवॉइस बिलिंग
  • एक नामित संपर्क
हमसे बात करें

सवाल

डेवलपर पूछते हैं

क्या API को आज़माने का कोई मुफ़्त तरीका है?

हाँ। साइन इन किया कोई भी उपयोगकर्ता मुफ़्त में सैंडबॉक्स कुंजी बना सकता है। सैंडबॉक्स कॉल प्रति मिनट 10 और प्रति काम 5 पेज तक सीमित हैं, हर आउटपुट पर “Sandbox” की मुहर लगती है, और टेस्ट डेटा 7 दिन बाद डिलीट हो जाता है।

मैं कौन से टूल कॉल कर सकता हूँ?

हमारे सर्वर पर चलने वाले 20 टूल, कंप्रेस और OCR से लेकर Office कन्वर्ज़न और PDF/A तक, साथ में ई-सिग्नेचर। GET /tools उन्हें उनके विकल्पों के साथ सूचीबद्ध करता है। 20 ब्राउज़र टूल आपके उपयोगकर्ताओं के ब्राउज़र में चलते हैं, इसलिए वे API v1 में नहीं हैं।

API के इस्तेमाल का शुल्क कैसे लगता है?

लाइव कुंजियाँ Pro और बिज़नेस के साथ आती हैं। कॉल वेबसाइट जैसी ही मासिक सीमाएँ इस्तेमाल करते हैं; उनसे ज़्यादा पर क्रेडिट लगते हैं। क्रेडिट पैक 500 क्रेडिट के लिए £5 से शुरू होते हैं और 12 महीने चलते हैं।

क्या आपके पास SDK हैं?

डॉक्यूमेंटेशन में हर एंडपॉइंट के लिए curl, Node और Python में कॉपी-पेस्ट करने लायक नमूने, एक OpenAPI 3.1 फ़ाइल और एक Postman कलेक्शन हैं, ताकि आप किसी भी भाषा में क्लाइंट बना सकें।

अगर मेरा वेबहुक एंडपॉइंट बंद हो तो क्या होगा?

हम तीन बार और कोशिश करते हैं, 1 मिनट, 10 मिनट और 1 घंटे बाद, फिर डिलीवरी को विफल चिह्नित कर देते हैं। आप उसे अपने अकाउंट से या API से दोबारा भेज सकते हैं।

इसी हफ़्ते PDF सुविधाएँ शुरू करें।

एक मिनट में सैंडबॉक्स कुंजी बनाएँ। कार्ड की ज़रूरत नहीं।