انتقل إلى المحتوى
نظرة عامة نظرة عامة أخبار أخبار
مشاركة

API & MCP

حساب واحد. ثلاثة مسارات: REST، MCP و llms.txt.

نفس الأدوات الـ 300+ من API/MCP — سواء قمت بالدمج عبر REST، أو العمل داخل عميل الذكاء الاصطناعي عبر MCP، أو تسليم ملف llms.txt.

حساب واحد، مستضاف في الاتحاد الأوروبي: خلف كل مسار تكمن نفس طبقة المستندات.

لا حاجة إلى SDK EU-مضيف REST و MCP

البداية السريعة

من الأمر البرمجي إلى أول استدعاء لـ API

لا حاجة لقراءة التوثيق: يقرأ وكيل البرمجة ملف llms.txt ويعرف بعد ذلك القدرات، والمصادقة، والنقاط النهائية.

  1. تسليم ملف llms.txt يقوم الوكيل بقراءة الوصف القابل للقراءة آلياً لـ API.
  2. ربط الحساب حساب لـ REST وMCP، ورمز مميز في الرأس.
  3. وصف التطبيق وصف ما يجب إنشاؤه باللغة الطبيعية.
موجه لـ Claude أو ChatGPT أو Cursor
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
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"

المكالمة الأولى 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.

أسئلة

أسئلة شائعة حول 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 على نفس نقاط النهاية لتجربتها مباشرة.

أين تودون تجربة PaperOffice؟

تم ربط الكمبيوتر والهاتف الذكي: مساحة العمل على جهاز الحاسوب، والالتقاط عبر الهاتف.

لقد أصبحت النسخة التجريبية الخاصة بك جاهزة

من أين ترغبون في البدء؟

تم تحسين مساحة العمل الكاملة لأجهزة الكمبيوتر. وتُعد النسخة المحمولة مناسبة لالتقاط المستندات ومراجعتها والموافقة عليها.

app.paperoffice.ai

البدء على الكمبيوتر

سنرسل رابط الدخول الشخصي الخاص بك إلى بريدك الإلكتروني.

التسجيل مجاناً فتح التطبيق تطبيق PaperOffice المنتج الكامل: ويب وسطح مكتب وجوال. التقاط المستندات وتنظيمها والبحث فيها والعمل عليها مع الفريق. يلزم حساب مجاني فتح ساحة التجربة ساحة التجربة جرّبوا وظائف محددة فوراً — دون تسجيل، بمفتاح API تجريبي مقيّد. بدون تسجيل، لكن بمفتاح API تجريبي مقيّد