মূল কনটেন্টে যান

আপনার পরের টুল খুঁজুন

ডেভেলপার API ও অটোমেশন

MAXScanner-এর ওপর ডকুমেন্ট অটোমেশন তৈরি করুন

ডকুমেন্ট রূপান্তর, একত্রকরণ ও OCR-এর জন্য একটি REST API — সাথে Zapier, Make ও n8n-এর পূর্ণ সমর্থন। ফ্রিতে শুরু করুন, কোনো ক্রেডিট কার্ড লাগে না।

দ্রুত শুরু

  1. সাইন ইন করে আপনার ড্যাশবোর্ড খুলুন, তারপর API & Automation → API Keys → Create New Key।
  2. কী-টি কপি করুন (একবারই দেখানো হয়) — দেখতে mxs_xxxxxxxx_xxxxxxxxxxxx-এর মতো।
  3. প্রতিটি অনুরোধে এটি Bearer টোকেন হিসেবে পাঠান: Authorization: Bearer YOUR_API_KEY।
curl -X POST https://maxscanner.app/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/report.docx","filename":"report.docx","format":"pdf"}' \
  --output report.pdf
লাইভ

এখনই API চেষ্টা করুন

এটি আসল /api/v1/sandbox/convert এন্ডপয়েন্ট কল করে এবং সঙ্গে সঙ্গে তৈরি একটি ছোট ডেমো ডকুমেন্ট রূপান্তর করে। কোনো API কী লাগে না — আর এটি শুধু maxscanner.app-এর এই পেজ থেকেই কাজ করে, তাই অন্য কোথাও এমবেড বা স্ক্র্যাপ করা যায় না।

রেট লিমিট ও ফ্রি ক্রেডিট

ফ্রি প্ল্যান

দিনে 10টি

এবং মাসে 100টি অনুরোধ, চিরকাল ফ্রি। কোনো ক্রেডিট কার্ড লাগে না।

পেইড প্ল্যান

2,000 – সীমাহীন

Starter (মাসে 2,000 ক্রেডিট), Pro (মাসে 10,000), Business (সীমাহীন)।

পেইড প্ল্যানে প্রতিটি অপারেশনে ক্রেডিট খরচ হয়:

রূপান্তর — 2 ক্রেডিটএকত্রকরণ — 1 ক্রেডিটOCR — 3 ক্রেডিটব্যবহার যাচাই — ফ্রি

এন্ডপয়েন্ট

বেস URL: https://maxscanner.app/api/v1

GET/healthফ্রি, কী লাগে না

API চালু আছে কি না দেখুন — Zapier-এর “Test connection” ধাপে কাজে আসে।

রেসপন্স

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usageফ্রি

যে কী পাঠাচ্ছেন, তার বর্তমান প্ল্যান ও বাকি কোটা দেখুন।

রেসপন্স

{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
  "remaining": { "today": 7, "this_month": 84 } }
POST/convert2 ক্রেডিট

একটি URL-এ থাকা ডকুমেন্টকে অন্য ফরম্যাটে রূপান্তর করুন (pdf, docx, xlsx, pptx, txt, html, png, ...)।

অনুরোধের বডি

{ "url": "https://example.com/report.docx",
  "filename": "report.docx", "format": "pdf" }

রেসপন্স

বাইনারি ফাইল (Content-Type চাওয়া ফরম্যাটের সাথে মেলে)
POST/merge1 ক্রেডিট

URL হিসেবে দেওয়া 2-20টি PDF দেওয়া ক্রমে একটি PDF-এ একত্র করুন।

অনুরোধের বডি

{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }

রেসপন্স

বাইনারি ফাইল (application/pdf)
POST/ocr3 ক্রেডিট

আসল OCR দিয়ে স্ক্যান করা ছবি বা PDF থেকে লেখা বের করুন — কোনো টেক্সট লেয়ার না থাকলেও কাজ করে।

অনুরোধের বডি

{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }

রেসপন্স

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 ক্রেডিট

অটোমেশন থেকে আপনার MAXScanner লাইব্রেরিতে একটি ফাইল পাঠান — /convert-এর উল্টো দিক।

অনুরোধের বডি

{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }

রেসপন্স

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribeফ্রি

নির্দিষ্ট এক ধরনের ভবিষ্যৎ ইভেন্ট পেতে একটি ওয়েবহুক URL নিবন্ধন করুন। নিচে “Webhooks, Zapier & n8n” দেখুন।

অনুরোধের বডি

{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }

রেসপন্স

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribeফ্রি

আইডি দিয়ে একটি ওয়েবহুক সাবস্ক্রিপশন সরান।

অনুরোধের বডি

{ "id": "..." }

রেসপন্স

{ "success": true }
GET/hooksফ্রি

আপনার সক্রিয় ওয়েবহুক সাবস্ক্রিপশনের তালিকা দেখুন, প্রতিটির শেষ ডেলিভারির অবস্থাসহ।

রেসপন্স

{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }

/convert যা সমর্থন করে (শুধু অফিস ফরম্যাট নয়)

Word / Excel / PowerPointPDFপ্রচলিত “অফিস থেকে PDF”
PDFWord / সাধারণ টেক্সট / HTML“PDF থেকে অফিস”
PDFPNG / JPG ছবিপ্রতি পৃষ্ঠায় একটি ছবি
PNG / JPG ছবিPDFছবিকে PDF পৃষ্ঠায় বসানো

Zapier, Make, n8n ও ওয়েবহুক

MAXScanner Android অ্যাপকে 5,000+ অ্যাপের সাথে যুক্ত করুন। সাবস্ক্রাইব করে ইন্টিগ্রেশন কী পেতে অ্যাপে Settings → Zapier & Automation (অথবা Tools-এ API & Automation টাইল) খুলুন, তারপর Zapier-এর সংযোগ ধাপে সেটিকে MAXScanner API কী হিসেবে ব্যবহার করুন — একই কী ওপরের সরাসরি REST কলেও কাজ করে।

উপলব্ধ ট্রিগার

নতুন স্ক্যান করা ডকুমেন্টscan.createdসব প্ল্যান

অ্যাপে নতুন ডকুমেন্ট স্ক্যান হলেই চালু হয়।

নতুন PDF এক্সপোর্টpdf.exportedসব প্ল্যান

কোনো ডকুমেন্ট গ্রুপ PDF-এ এক্সপোর্ট হলে চালু হয়।

নতুন জিওট্যাগ করা স্ক্যানgeotag.capturedPro ও তার ওপরে

লোকেশনের তথ্যসহ (ঠিকানা, শহর, স্থানাঙ্ক) ট্যাগ করা স্ক্যানের জন্য চালু হয়।

নতুন টাইমস্ট্যাম্প ক্যাপচারtimestamp.capturedBusiness

টাইমস্ট্যাম্প দেওয়া ক্যাপচারের জন্য চালু হয়।

নতুন OCR টেক্সট বের করা হয়েছেocr.completedPro ও তার ওপরে

কোনো স্ক্যানের জন্য ডিভাইসে OCR টেক্সট পাওয়া গেলে চালু হয়।

নতুন QR কোড স্ক্যানqr.scannedসব প্ল্যান

অ্যাপে QR কোড স্ক্যান হওয়ার মুহূর্তেই, ডিকোড করা লেখাসহ চালু হয়।

Make.com

ভিজ্যুয়াল অটোমেশন সিনারিও

n8n

নিজের সার্ভারে চালানো ওয়ার্কফ্লো অটোমেশন

ওয়েবহুক

অন্য যেকোনো কিছুর জন্য সরাসরি HTTP কলব্যাক

এখানে তিনটি প্ল্যাটফর্মই একইভাবে কাজ করে: তারা আপনাকে একটি URL দেয়, আর আপনি /hooks/subscribe দিয়ে MAXScanner-কে সেখানে POST করতে বলেন। এখনও ইনস্টল করার মতো নিজস্ব Zapier অ্যাপ নেই — এটি Zapier-এর নিজস্ব সাধারণ Webhooks by Zapier অ্যাকশন ব্যবহার করে, যা আজই কাজ করে।

⚡ Zapier ধাপে ধাপে

  1. একটি Zap তৈরি করুন → Webhooks by Zapier অ্যাপ খুঁজুন → ট্রিগার ইভেন্ট হিসেবে Catch Hook বেছে নিন।
  2. Zapier আপনাকে একটি কাস্টম ওয়েবহুক URL দেখাবে (যেমন https://hooks.zapier.com/hooks/catch/...)। সেটি কপি করুন।
  3. সেই URL আর আপনার চাওয়া ইভেন্ট দিয়ে MAXScanner-এর /hooks/subscribe একবার কল করুন (নিচের curl উদাহরণ দেখুন)।
  4. Zapier-এ ফিরে অ্যাপ থেকে একটি পরীক্ষামূলক ইভেন্ট চালান (যেমন একটি ডকুমেন্ট স্ক্যান করুন) — Catch Hook ধাপে নমুনা ডেটা দেখা যাওয়ার কথা। সেখান থেকে আপনার Zap-এর অ্যাকশন ধাপ তৈরি করতে থাকুন (Google Drive, Sheets, Slack, ইমেইল, যেকোনো কিছু)।

🔄 n8n ধাপে ধাপে

  1. একটি নতুন ওয়ার্কফ্লোতে Webhook ট্রিগার নোড যোগ করুন। এটিকে POST অনুরোধ নেওয়ার জন্য সেট করুন।
  2. নোডের Production URL কপি করুন (লাইভ হওয়ার জন্য আগে ওয়ার্কফ্লোটি চালু করুন)।
  3. সেই URL ও আপনার বেছে নেওয়া ইভেন্ট দিয়ে /hooks/subscribe কল করুন।
  4. অ্যাপ থেকে একটি পরীক্ষামূলক ইভেন্ট চালান — Webhook নোড পেলোডটি ধরবে, যা আপনার ওয়ার্কফ্লোর বাকি অংশে যুক্ত করার জন্য প্রস্তুত।

curl দিয়ে সাবস্ক্রাইব করুন

curl -X POST https://maxscanner.app/api/v1/hooks/subscribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"scan.created","targetUrl":"https://hooks.zapier.com/hooks/catch/.../..."}'

আপনার ডকুমেন্টের কাজ অটোমেট করতে প্রস্তুত?

একটি ফ্রি API কী তৈরি করুন — দিনে 10টি, মাসে 100টি অনুরোধ, কোনো কার্ড লাগে না।