API এবং ওয়েবহুক
ডকুমেন্ট আপলোড এবং পড়া REST API এর মাধ্যমে উপলব্ধ। অ্যাকাউন্ট, ফোল্ডার, লেবেল এবং সংযোগের পরিচালনা অ্যাপ্লিকেশনেই থাকে।
কী
এটি সেটিংসে প্রতিষ্ঠিত হয় → ডেভেলপারদের জন্য। কীটি একবার প্রদর্শিত হয়, প্রতিষ্ঠার সময় — এরপর আর নয়, কারণ এটি কেবল তার হ্যাশ সংরক্ষণ করে। হারিয়ে যাওয়া কী পুনরুদ্ধার করা যায় না, নতুন একটি তৈরি করতে হয় এবং পুরানোটি মুছে ফেলা হয়। সর্বাধিক পাঁচটি কী থাকতে পারে, প্রত্যেকটির ঐচ্ছিক বৈধতার সময়সীমা দুই বছর পর্যন্ত।
কীটি X-API-Key হেডারে পাঠানো হয়।
API কি করতে পারে
| অপারেশন | বিবরণ |
|---|---|
POST /api/upload | নির্বাচিত ফাইল আপলোড: ফরম্যাট, দিক, প্রকার, মুদ্রা, স্কিমা, ফোল্ডার, ওয়েবহুক |
POST /api/upload/url | একই কাজ পাবলিক ঠিকানার মাধ্যমে; আমরা ফাইলটি স্বয়ংক্রিয়ভাবে ডাউনলোড করব |
GET /api/jobs | ফিল্টার এবং পেজিনেশন সহ ডকুমেন্টের তালিকা |
GET /api/jobs/{id} | স্টেটাস, পড়া ডাটা, আবিষ্কার এবং লক্ষ্য ফরম্যাটে ফলাফল |
GET /api/jobs/{id}/original | আপলোড করা ফাইল |
DELETE /api/jobs/{id} | ফাঁকা করত এ মুছে ফেলুন |
এক্সেল এবং পিডিএফ ফলস্বরূপ Base64 আকারে আসে। যিনি ফলস্বরূপ দরকার নেই, তিনি
includeResult=false পাঠান, এতে সার্ভারে রূপান্তর বাঁচানো হয়।
OpenAPI ফরম্যাটে ইন্টারফেসের বর্ণনা /api/docs ঠিকানায় পাওয়া যায়; লিংক
কীসমূহের ক্ষেত্রে সেটিংসে রয়েছে। বর্ণনাটি চলমান কোড থেকে উৎপন্ন হয়, তাই এটি
কীটিকে যা করছে তার সাথে সামঞ্জস্যপূর্ণ।
API থেকে ডকুমেন্টে যাচাই
প্রেরণের আগে যাচাই ডিফল্টভাবে কী দ্বারা আপলোড করা ডকুমেন্টের জন্যও প্রযোজ্য: ডকুমেন্টটি অ্যাপ্লিকেশনে নিশ্চিতকরণের জন্য অপেক্ষা করে এবং ওয়েবহুকটি তার পরে পাঠানো হয়। যে কেউ এমন একটি ইন্টিগ্রেশন তৈরি করছে যেখানে কেউ স্ক্রীনের সামনে নেই, সেটিংসে → প্রেরণের পূর্বে যাচাইয়ে API চ্যানেলটি অপসারণ করতে পারে অথবা যাচাইটি বন্ধ করতে পারে।
MCP
AI এজেন্টদের জন্য, /api/mcp ঠিকানায় MCP সার্ভার একই কী দ্বারা রয়েছে। এটি না পড়তে এবং খোঁজার জন্য
ডকুমেন্টগুলি পড়তে সক্ষম; আপলোড করা যাবে না; আপলোডটি একটি সম্পন্ন কমান্ড হিসেবে ফিরে আসবে,
যা এজেন্ট নিজেই চালাবে।
ওয়েবহুক
স্টেটাসের জন্য অনুসন্ধানের পরিবর্তে, সম্পন্ন হলে ফলাফল পাঠাতে বলুন। ঠিকানা সমগ্র
অ্যাকাউন্টের জন্য সেটিংসে → ডেভেলপারদের জন্য সেট করা হয়, অথবা পৃথক আপলোডের ক্ষেত্রে
targetWebhookUrl প্যারামিটারে। সেটিংসে একটি বোতাম পরীক্ষামূলক বার্তা প্রেরণ করবে।
এটি POST JSON দিয়ে পাঠানো হয়: ডকুমেন্টের আইডি, ফাইলের নাম, ফরম্যাট এবং লক্ষ্য
ফরম্যাটে ফলাফল। যখন ডকুমেন্টটি যাচাই পাস করে অথবা পুনরায় প্রক্রিয়া করা হয়, তখন
ওয়েবহুকটি দ্বিতীয়বার আসবে সংশোধনের নির্দেশক (IsCorrection) সহ।
বার্তাটি স্বাক্ষরিত হয়নি। আপনার ঠিকানায় আপনার নিজস্ব সিক্রেট টোকেন দিয়ে প্রেরকটি যাচাই করুন। প্রাইভেট নেটওয়ার্কের ঠিকনাসমূহ প্রত্যাখ্যান করা হয়।
অতীন্দ্রিয় বিতরণ বেড়েছে আরও বড় বিলম্ব সহ, প্রায় চার ও অর্ধ ঘণ্টার মধ্যে একাদশ চেষ্টা। প্রতিটি চেষ্টা আপনার পক্ষ থেকে কার্যকলাপ এবং প্রতিক্রিয়াসহ থাকবে; ডকুমেন্টে তালিকায় বিতরণ ফলাফলের আইকন রয়েছে।
সীমা
API এর নিজস্ব মিনিটে কল করার জন্য সীমা নেই; আপলোডিং ক্রেডিট দ্বারা সীমাবদ্ধ, ফাইলের আকার ট্যারিফ অনুযায়ী এবং ডকুমেন্টের জন্য বিশাল বিশাল বিশাল। প্রত্যাখ্যান একটি 400 ত্রুটি হিসাবে আসবে, যেটি কারণ নির্দেশ করে। MCP সার্ভার সেকেন্ডে দশটি অনুসন্ধানে সীমাবদ্ধ।