Macaaw PDF API
কমপ্রেস, কনভার্ট ও সাইনের জন্য PDF API
20টি PDF টুল ও ই-সিগনেচারের জন্য একটি REST API। প্রতিটি টাস্ক লন্ডনে আমাদের সার্ভারে চলে এবং ফাইল 2 ঘণ্টার মধ্যে মুছে যায়।
বিনামূল্যে স্যান্ডবক্স কী নিনAPI ডকুমেন্টেশন পড়ুন
- OpenAPI 3.1
- Postman কালেকশন
- ফ্রি স্যান্ডবক্স
- সাইন করা ওয়েবহুক
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ফাইল মুছে যাওয়া পর্যন্ত
- ০£স্যান্ডবক্সের জন্য
যা বানাতে পারেন
যে PDF কাজ আপনার প্রোডাক্টের নিজে সামলানোর দরকার নেই
সংরক্ষণের আগে আপলোড ছোট করুন
ব্যবহারকারীরা PDF আপলোড করার মুহূর্তেই সেগুলো কমপ্রেস করুন, অথবা নির্দিষ্ট সাইজের মধ্যে আনুন।
অফিস ফাইলকে PDF-এ কনভার্ট করুন
Word, Excel, PowerPoint, OpenDocument ও HTML থেকে PDF, লেআউট অটুট রেখে।
স্ক্যানকে সার্চযোগ্য করুন
27টি ভাষায় লেখা শনাক্তকরণ, আর্কাইভের জন্য PDF/A, এবং টেবিল সরাসরি Excel-এ।
নিজের অ্যাপ থেকে চুক্তি পাঠান
PDF থেকে ডকুমেন্ট তৈরি করুন, টেক্সট ট্যাগ দিয়ে ঘর বসান, পাঠান এবং সাইন করা কপি ডাউনলোড করুন।
আপনার প্রোডাক্টে সাইনিং এমবেড করুন
আপনার অনুমোদিত অরিজিনের মধ্যে সীমাবদ্ধ রেখে নিজের সাইটের ভেতরেই সাইনিং সেশন খুলুন।
ওয়েবহুকসহ ব্যাচ চালান
শত শত টাস্ক শুরু করুন এবং প্রতিটি শেষ হলে একটি সাইন করা কলব্যাক পান।
কীভাবে কাজ করে
চার কলে কী থেকে ফলাফল
একটি কী বানান
আপনার অ্যাকাউন্টে স্যান্ডবক্স কী বানান। প্রস্তুত হলে লাইভ কী-তে যান।
অ্যাকাউন্ট › ডেভেলপারএকটি টাস্ক শুরু করুন
একটি মাল্টিপার্ট অনুরোধে ফাইল ও টুল পাঠান।
POST /public/v1/tasksশেষ হলে জানুন
task_completed-এ সাবস্ক্রাইব করুন, অথবা টাস্ক পোল করুন।
webhook: task_completedডাউনলোড
ফলাফল নিন, তারপর মুছুন অথবা মেয়াদ শেষ হতে দিন।
GET /tasks/{id}/download
এন্ডপয়েন্ট
একটি ছোট, অনুমানযোগ্য API
বেস URL https://macaaw.com/public/v1 · snake_case কী-সহ JSON · Authorization: API-Key …
টাস্ক · 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-তে প্রসেসিং, সঙ্গে ইঞ্জিনিয়ারিং টিমের প্রত্যাশিত নিয়ন্ত্রণ।
- আপনার নিয়ন্ত্রণের কীলাইভ ও স্যান্ডবক্স কী একবারই দেখানো হয় এবং হ্যাশ হিসেবে রাখা হয়। অ্যাকাউন্ট থেকে যেকোনো কী প্রত্যাহার করুন।
- সাইন করা ওয়েবহুকপ্রতিটি ডেলিভারিতে আপনার শেয়ার্ড কী দিয়ে বানানো বডির HMAC-SHA256 সহ ?signature= থাকে।
- দ্রুত মুছে যাওয়া ফাইলটাস্কের ফাইল ফ্রি অ্যাকাউন্টে ১ ঘণ্টা এবং Pro ও Business-এ ২ ঘণ্টা রাখা হয়, তারপর সেগুলো চলে যায়। DELETE সেগুলো তখনই সরিয়ে দেয়।
- UK-তে প্রসেসিংপ্রতিটি টাস্ক লন্ডনে আমাদের সার্ভারে চলে। রিকোয়েস্ট লগে ফাইলের বিষয়বস্তু বা ফাইলের নাম কখনও রাখা হয় না।
- ন্যায্য রেট সীমাব্যবহারকারীপ্রতি মিনিটে ১২০টি নতুন টাস্ক, প্রতিটি 429-এ Retry-After সহ।
- নিরাপদে আবার চেষ্টাএকটি Idempotency-Key পাঠান, তাহলে পুনরাবৃত্ত অনুরোধ 24 ঘণ্টা পর্যন্ত প্রথম ফলাফলই ফেরত দেয়।
দাম
বিনামূল্যে শুরু করুন। বড় হলে দিন।
স্যান্ডবক্স
০£
- প্রতিটি এন্ডপয়েন্ট, টেস্ট ডেটাসহ
- মিনিটে ১০টি অনুরোধ
- টাস্কপ্রতি সর্বোচ্চ ৫ পেজ
- আউটপুটে “Sandbox” স্ট্যাম্প
- টেস্ট ডেটা ৭ দিন পর মুছে যায়
লাইভ, Pro বা Business-এ
৪.৯৯£ থেকেমাসে, বছরের হিসাবে বিল
- আপনার প্ল্যানের মাসিক সীমা ব্যবহার করে
- তারপর ক্রেডিট: ৫০০-এর জন্য ৫£ থেকে
- প্রতি OCR পেজে ১ ক্রেডিট, প্রতি অফিস কনভার্সনে ২ ক্রেডিট
- মিনিটে ১২০টি নতুন টাস্ক
Enterprise
ভলিউম প্রাইসিং
- পেজ ও কনভার্সনে ভলিউম প্রাইসিং
- কাস্টম সীমা, চুক্তির মাধ্যমে বিক্রি
- বার্ষিক ইনভয়েস বিলিং
- একজন নির্দিষ্ট যোগাযোগকারী
প্রশ্নোত্তর
ডেভেলপাররা জিজ্ঞাসা করেন
API চেষ্টা করার কি কোনো বিনামূল্যের উপায় আছে?
হ্যাঁ। সাইন ইন করা যে কেউ বিনামূল্যে স্যান্ডবক্স কী বানাতে পারেন। স্যান্ডবক্স কল মিনিটে 10টি এবং টাস্কপ্রতি 5 পেজে সীমাবদ্ধ, প্রতিটি আউটপুটে “Sandbox” স্ট্যাম্প থাকে, এবং টেস্ট ডেটা 7 দিন পর মুছে যায়।
আমি কোন টুলগুলো ডাকতে পারি?
আমাদের সার্ভারে চলা 20টি টুল, Compress ও OCR থেকে অফিস কনভার্সন ও PDF/A পর্যন্ত, এবং ই-সিগনেচার। GET /tools সেগুলো অপশনসহ তালিকাভুক্ত করে। 20টি ব্রাউজার টুল আপনার ব্যবহারকারীদের ব্রাউজারে চলে, তাই সেগুলো API v1-এ নেই।
API ব্যবহারে কীভাবে চার্জ হয়?
লাইভ কী Pro ও Business-এর সঙ্গে আসে। কল ওয়েবসাইটের মতোই মাসিক সীমা ব্যবহার করে; তার বেশি হলে ক্রেডিট লাগে। ক্রেডিট প্যাক শুরু হয় 500 ক্রেডিটের জন্য ৫£ থেকে এবং 12 মাস থাকে।
আপনাদের কি SDK আছে?
ডকুমেন্টেশনে প্রতিটি এন্ডপয়েন্টের জন্য curl, Node ও Python-এ কপি-পেস্ট করার নমুনা, একটি OpenAPI 3.1 ফাইল এবং একটি Postman কালেকশন আছে, তাই যেকোনো ভাষায় ক্লায়েন্ট বানাতে পারেন।
আমার ওয়েবহুক এন্ডপয়েন্ট বন্ধ থাকলে কী হয়?
আমরা আরও তিনবার চেষ্টা করি, ১ মিনিট, ১০ মিনিট ও ১ ঘণ্টা পরে, তারপর ডেলিভারিকে ব্যর্থ চিহ্নিত করি। আপনার অ্যাকাউন্ট থেকে বা API দিয়ে এটি আবার পাঠাতে পারেন।
এই সপ্তাহেই PDF ফিচার চালু করুন।
এক মিনিটে স্যান্ডবক্স কী বানান। কার্ড লাগে না।