দ্রুত শুরু
- সাইন ইন করে আপনার ড্যাশবোর্ড খুলুন, তারপর API & Automation → API Keys → Create New Key।
- কী-টি কপি করুন (একবারই দেখানো হয়) — দেখতে
mxs_xxxxxxxx_xxxxxxxxxxxx-এর মতো। - প্রতিটি অনুরোধে এটি 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 (সীমাহীন)।
পেইড প্ল্যানে প্রতিটি অপারেশনে ক্রেডিট খরচ হয়:
এন্ডপয়েন্ট
বেস URL: https://maxscanner.app/api/v1
/healthফ্রি, কী লাগে নাAPI চালু আছে কি না দেখুন — Zapier-এর “Test connection” ধাপে কাজে আসে।
রেসপন্স
{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }/usageফ্রিযে কী পাঠাচ্ছেন, তার বর্তমান প্ল্যান ও বাকি কোটা দেখুন।
রেসপন্স
{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
"remaining": { "today": 7, "this_month": 84 } }/convert2 ক্রেডিটএকটি URL-এ থাকা ডকুমেন্টকে অন্য ফরম্যাটে রূপান্তর করুন (pdf, docx, xlsx, pptx, txt, html, png, ...)।
অনুরোধের বডি
{ "url": "https://example.com/report.docx",
"filename": "report.docx", "format": "pdf" }রেসপন্স
বাইনারি ফাইল (Content-Type চাওয়া ফরম্যাটের সাথে মেলে)/merge1 ক্রেডিটURL হিসেবে দেওয়া 2-20টি PDF দেওয়া ক্রমে একটি PDF-এ একত্র করুন।
অনুরোধের বডি
{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }রেসপন্স
বাইনারি ফাইল (application/pdf)/ocr3 ক্রেডিটআসল OCR দিয়ে স্ক্যান করা ছবি বা PDF থেকে লেখা বের করুন — কোনো টেক্সট লেয়ার না থাকলেও কাজ করে।
অনুরোধের বডি
{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }রেসপন্স
{ "text": "...", "pages": 3, "language": "eng" }/documents/import1 ক্রেডিটঅটোমেশন থেকে আপনার MAXScanner লাইব্রেরিতে একটি ফাইল পাঠান — /convert-এর উল্টো দিক।
অনুরোধের বডি
{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }রেসপন্স
{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }/hooks/subscribeফ্রিনির্দিষ্ট এক ধরনের ভবিষ্যৎ ইভেন্ট পেতে একটি ওয়েবহুক URL নিবন্ধন করুন। নিচে “Webhooks, Zapier & n8n” দেখুন।
অনুরোধের বডি
{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }রেসপন্স
{ "id": "...", "event": "scan.created", "targetUrl": "..." }/hooks/unsubscribeফ্রিআইডি দিয়ে একটি ওয়েবহুক সাবস্ক্রিপশন সরান।
অনুরোধের বডি
{ "id": "..." }রেসপন্স
{ "success": true }/hooksফ্রিআপনার সক্রিয় ওয়েবহুক সাবস্ক্রিপশনের তালিকা দেখুন, প্রতিটির শেষ ডেলিভারির অবস্থাসহ।
রেসপন্স
{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }/convert যা সমর্থন করে (শুধু অফিস ফরম্যাট নয়)
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 ধাপে ধাপে
- একটি Zap তৈরি করুন → Webhooks by Zapier অ্যাপ খুঁজুন → ট্রিগার ইভেন্ট হিসেবে Catch Hook বেছে নিন।
- Zapier আপনাকে একটি কাস্টম ওয়েবহুক URL দেখাবে (যেমন
https://hooks.zapier.com/hooks/catch/...)। সেটি কপি করুন। - সেই URL আর আপনার চাওয়া ইভেন্ট দিয়ে MAXScanner-এর
/hooks/subscribeএকবার কল করুন (নিচের curl উদাহরণ দেখুন)। - Zapier-এ ফিরে অ্যাপ থেকে একটি পরীক্ষামূলক ইভেন্ট চালান (যেমন একটি ডকুমেন্ট স্ক্যান করুন) — Catch Hook ধাপে নমুনা ডেটা দেখা যাওয়ার কথা। সেখান থেকে আপনার Zap-এর অ্যাকশন ধাপ তৈরি করতে থাকুন (Google Drive, Sheets, Slack, ইমেইল, যেকোনো কিছু)।
🔄 n8n ধাপে ধাপে
- একটি নতুন ওয়ার্কফ্লোতে Webhook ট্রিগার নোড যোগ করুন। এটিকে POST অনুরোধ নেওয়ার জন্য সেট করুন।
- নোডের Production URL কপি করুন (লাইভ হওয়ার জন্য আগে ওয়ার্কফ্লোটি চালু করুন)।
- সেই URL ও আপনার বেছে নেওয়া ইভেন্ট দিয়ে
/hooks/subscribeকল করুন। - অ্যাপ থেকে একটি পরীক্ষামূলক ইভেন্ট চালান — 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/.../..."}'