API & MCP
حساب واحد. ثلاثة مسارات: REST، MCP و llms.txt.
نفس الأدوات الـ 300+ من API/MCP — سواء قمت بالدمج عبر REST، أو العمل داخل عميل الذكاء الاصطناعي عبر MCP، أو تسليم ملف llms.txt.
حساب واحد، مستضاف في الاتحاد الأوروبي: خلف كل مسار تكمن نفس طبقة المستندات.
- بنية الاتحاد الأوروبي الخاصة تظل بياناتك في أوروبا.
- ISO 27001 نشط معتمد من حيث الأمان.
- SOC 2 النوع الثاني نشط معايير التدقيق الدولية.
- أكثر من 24 عاماً من الخبرة مجرب. مستقر. آمن للمستقبل.
Showroom
ما يمكن بناؤه باستخدام PaperOffice
من مكالمة API الفردية إلى وكيل المستندات: يعرض Showroom التطبيقات والمطالبات والوصفات التقنية.
فحص وإصدار الفواتير بشكل مستقل
استخراج البيانات، مطابقة الموردين، اكتشاف التكرارات، الإصدار ونتيجة قابلة للمراجعة في تدفق عمل واحد.
Document AIفحص العقود من حيث المخاطر
اكتشاف البنود والمواعيد النهائية والانحرافات تلقائيًا.
Complianceالتحقق من صحة العناوين
استخراج البيانات الجغرافية وتوثيقها والتحقق منها.
Transformationإعداد ملفات PDF للوكلاء
الضوء البصري المحسّن، والهيكل، والبيانات الوصفية للأنظمة اللاحقة.
Knowledgeالاستعلام عن المعرفة مباشرة
الإجابات من مجموعة الوثائق الحالية بدلاً من النسخ الاحتياطية.
البداية السريعة
من الأمر البرمجي إلى أول استدعاء لـ API
لا حاجة لقراءة التوثيق: يقرأ وكيل البرمجة ملف llms.txt ويعرف بعد ذلك القدرات، والمصادقة، والنقاط النهائية.
- تسليم ملف llms.txt يقوم الوكيل بقراءة الوصف القابل للقراءة آلياً لـ API.
- ربط الحساب حساب لـ REST وMCP، ورمز مميز في الرأس.
- وصف التطبيق وصف ما يجب إنشاؤه باللغة الطبيعية.
Read https://api.paperoffice.ai/latest/docs/llms.txt and understand the available Document Operations.
Then build a workflow that:
1) Analyses incoming invoices
2) Checks required fields
3) Returns the result as structured JSON
4) Uses Authorization: Bearer po_ut_YOUR_API_KEY API مفهوم · جاهز للمكالمة الأولى API
curl -X POST \ "https://api.paperoffice.ai/latest/job/add/workflow" \ -H "Authorization: Bearer po_ut_YOUR_API_KEY" \ -F "[email protected]" \ -F "idp_collection=invoice" \ -F "model=basic-pro-max" import requestsresponse = requests.post( "https://api.paperoffice.ai/latest/job/add/workflow", headers={"Authorization": "Bearer po_ut_YOUR_API_KEY"}, files={"file_1": open("invoice.pdf", "rb")}, data={"idp_collection": "invoice", "model": "basic-pro-max"},)print(response.json()) const form = new FormData();form.append("file_1", new Blob([await readFile("invoice.pdf")]), "invoice.pdf");form.append("idp_collection", "invoice");form.append("model", "basic-pro-max");const response = await fetch("https://api.paperoffice.ai/latest/job/add/workflow", { method: "POST", headers: { Authorization: "Bearer po_ut_YOUR_API_KEY" }, body: form,});console.log(await response.json()); <?php$ch = curl_init("https://api.paperoffice.ai/latest/job/add/workflow");curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer po_ut_YOUR_API_KEY"], CURLOPT_POSTFIELDS => [ "file_1" => new CURLFile("invoice.pdf"), "idp_collection" => "invoice", "model" => "basic-pro-max", ],]);echo curl_exec($ch); المكالمة الأولى API
كيف تبدو المكالمة الأولى API
طلب POST إلى /latest/job/add/workflow مع ملف ومجموعة ونموذج — بالإضافة إلى رمز حامل (Bearer Token) في الرأس. لا يتطلب الأمر أكثر من ذلك.
- رأس واحد
Authorization: Bearer po_ut_YOUR_API_KEY — لا يوجد تدفق OAuth، ولا منطق تحديث، ولا ضرورة لاستخدام SDK.
- خط أنابيب لكل استدعاء
المسار بعد /latest/job/add/ يحدد خط الأنابيب؛ يوفر workflow معالجة مستندات ذكية (IDP) منظمة.
- النتيجة أو job_id
بشكل افتراضي، تحافظ API على الاتصال وتقدم النتيجة مضمّنة؛ وإلا ستُرد حالة HTTP 202 مع job_id و poll_url.
ثلاثة مسارات وصول
كيف يندمج PaperOffice في البنية التقنية
استخدم مسار الوصول الذي يحتاجه المنتج أو الوكيل. يبقى المستند هو المصدر الموثوق الوحيد.
للمنتجات الخاصة بك
استدعاء عمليات المستندات مباشرة من الخلفية البرمجية، سير العمل، أو SaaS.
- API القائم على JSON
- مهام غير متزامنة
- Webhooks والأحداث
لوكلاء الذكاء الاصطناعي
إدماج PaperOffice بشكل أصلي في Claude وChatGPT وCursor وعملاء MCP الآخرين.
- اكتشاف الأدوات
- الوصول المباشر إلى المستندات
- إجراءات خاضعة للرقابة
لوكلاء البرمجة
يفهم وكيل البرمجة القدرات والمصادقة والأمثلة على الفور.
- لا حاجة إلى SDK
- وثائق قابلة للقراءة آليًا
- قابل للنسخ المباشر
أسئلة
أسئلة شائعة حول API وMCP
ما الفرق بين REST وMCP وllms.txt؟
REST هو الواجهة لمنتجاتك الخاصة، بينما يجلب خادم MCP نفس الأدوات إلى عملاء الذكاء الاصطناعي مثل Claude وChatGPT أو Cursor، ويصف llms.txt كلاهما بشكل قابل للقراءة آليًا لوكلاء البرمجة. تعمل جميع طرق الوصول الثلاثة على نفس الحساب ونفس طبقة المستندات.
هل أحتاج إلى SDK؟
لا. تعتمد API على HTTP وJSON، وأي عميل HTTP كافٍ. بالنسبة لوكلاء البرمجة، توجد الوصف القابل للقراءة آلياً على https://api.paperoffice.ai/latest/docs/llms.txt.
كيف يمكنني المصادقة؟
باستخدام رمز مميز في رأس HTTP: Authorization: Bearer po_ut_YOUR_API_KEY. يمكنك معرفة أنواع المفاتيح المتاحة والغرض من كل منها في صفحة المصادقة والمفاتيح.
أين يمكنني العثور على أمثلة جاهزة؟
تحتوي Cookbook على نصوص برمجية وقوالب قابلة للنسخ، بينما تحتوي مجموعة Postman على نفس نقاط النهاية لتجربتها مباشرة.
المحطة التالية
كيف تستمر
الخطوة التالية الموصى بها في قمع المطورين وفرعان مناسبان.