مسح، توقيع، دردشة بالذكاء الاصطناعي
Mobile App
تتوافق التطبيق المحمول مع حسابكم عبر رمز QR ويوفر الماسح، التوقيع، الدردشة والمستندات لهواتفكم.
Publishable Keys
استدعاءات API آمنة للمتصفح. لا حاجة إلى خادم خلفي.
يجوز وضع Publishable Key (po_pk_) في الواجهة الأمامية: محدود النطاق، مرتبط بالأصل، ومحدود بالميزانية.
لأعمال Claude الفنية، ولوحة ChatGPT، وGrok، وأي تطبيق ويب خاص بكم.
بادئة خاصة po_pk_ مقيد افتراضيًا بـ Origin قابل للإلغاء في أي وقت
- بنية الاتحاد الأوروبي الخاصة بياناتكم تبقى في أوروبا.
- ISO/IEC 27001 معتمد معتمد من حيث الأمان.
- أكثر من 24 عاماً من الخبرة مجرب. مستقر. آمن للمستقبل.
مباشر من المتصفح
من AI-Canvas مباشرة إلى استدعاء API
يمكنكم بناء تطبيق لتحويل PDF إلى نص في أعمال Claude الفنية أو لوحة ChatGPT أو Grok. بدون خادم خلفي، كان استدعاء API يفشل سابقًا: كان CORS يحجبه، وكان المفتاح السري سيظهر في الكود المصدري، وكان المفتاح المفتوح سيثقل كاهل حسابكم. تسد المفاتيح القابلة للنشر هذه الفجوة تحديدًا.
يعمل في Claude ArtifactsChatGPT CanvasGrokأي تطبيق متصفح
في Claude، ChatGPT أو Grok إدراج
موجه يحول أي AI-Canvas إلى عرض تجريبي حقيقي مدعوم بـ API — بدون خادم خلفي.
اقرأ هذا المستند API:
https://api.paperoffice.ai/latest/docs/llms-full.txt قم ببناء تطبيق React من ملف واحد (Claude Artifact / ChatGPT Canvas / Grok):
يرفع المستخدم ملف PDF، ويقوم التطبيق باستدعاء
/job/add/paperoffice_aiocr___generate مباشرة من المتصفح
ويعرض النص المستخرج. المصادقة: Bearer po_pk_MY_PUBLISHABLE_KEY (اطلب من المستخدم إدخال المفتاح).
استخدم processing_lane=instant للحصول على نتائج متزامنة. يتم تعيين رأس Origin بواسطة المتصفح.اختاروا إعدادًا مسبقًا، وأنشئوا مفتاحًا، وألصقوه.
توفر لوحة التحكم إعدادات مسبقة للنطاقات والميزانية. تبقى حقول الأصل فارغة — ألصقوا ترويسة Origin من أدوات مطوري المتصفح، ثم انسخوا المفتاح إلى موجهكم.
const form = new FormData();form.append("file_1", fileInput.files[0]);form.append("processing_lane", "instant");form.append("client_wait", "true");const response = await fetch("https://api.paperoffice.ai/latest/job/add/paperoffice_aiocr___generate", { method: "POST", headers: { Authorization: "Bearer po_pk_YOUR_PUBLISHABLE_KEY" }, body: form,});console.log(await response.json());curl -X POST "https://api.paperoffice.ai/latest/job/add/paperoffice_aiocr___generate" \ -H "Authorization: Bearer po_pk_YOUR_PUBLISHABLE_KEY" \ -H "Origin: https://app.example.com" \ -F "file_1=@invoice.pdf" \ -F "processing_lane=instant" \ -F "client_wait=true"المكالمة الأولى
fetch من المتصفح، يحدد المتصفح Origin
يتم إرسال الطلب إلى POST /latest/job/add/{pipeline} — نفس نقطة النهاية المستخدمة مع مفتاح سري. الجديد هو نوع المفتاح ورأس Origin الذي يرسله المتصفح تلقائيًا.
- يأتي Origin من المتصفح
تقوم fetch بضبط رأس Origin تلقائيًا. يجب على البرامج النصية خارج المتصفح (مثل cURL أو Node) إرساله صراحةً — وإلا ستعيد API استجابة بـ 403 ORIGIN_HEADER_REQUIRED.
- النتيجة مضمنة
باستخدام processing_lane=instant و client_wait=true، تحافظ API على الاتصال وتقدم النتيجة مباشرة في الاستجابة.
- رموز أخطاء واضحة
402 BUDGET_EXHAUSTED، 403 DOMAIN_NOT_ALLOWED، 403 SCOPE_NOT_GRANTED، 429 RATE_LIMIT_EXCEEDED — كل حد يبلغ عن نفسه برمز خاص به.
مصفوفة الأمان
ست ضوابط، جميعها مفروزة من جانب الخادم
محدود النطاق، ومقيد بالأصل، ومحدد السقف بالميزانية، وقابل للإلغاء في أي وقت. يُفرض كل تحكم من جانب الخادم — ولهذا يمكن للمفتاح أن يوجد في كود الواجهة الأمامية.
-
محدودة النطاق
تصل المفاتيح فقط إلى مجموعات نقاط النهاية التي تطلقها صراحةً:
ocr:read،llm:generate،translate:textوغيرها. الإخراجات خارج النطاق تُرجع خطأ HTTP 403. -
مرتبطة بالأصل (Origin)
يجب أن تحتوي كل طلب على رأس Origin يتطابق مع القائمة المسموحة للمفتاح (استضافة دقيقة أو نمط عام لاسم النطاق الفرعي). إذا لم يتطابق، تُرجع API خطأ HTTP 403.
-
لا يوجد حد إضافي للدقائق
لا يوجد حد أقصى إضافي في الدقيقة خاص بـ po_pk_. تنطبق حدود المعدل الطبيعية لكل رمز على مستوى الحساب؛ ويحدد الإنفاق بالميزانية مدى الحياة.
-
ميزانية محدودة
يحمل كل مفتاح ميزانية مدى الحياة. بمجرد استنفادها، تعيد API الرمز HTTP 402 BUDGET_EXHAUSTED — يتوقف الإنفاق عند هذا الحد، وليس عند إصدار الفاتورة.
-
إلغاء فوري
يمكن إلغاء صلاحية المفاتيح في أي وقت من خلال الحساب. لن تقبل API بعد الآن أي مفتاح تم إلغاؤه.
-
مقفل تماماً
يظل HTTP DELETE بالإضافة إلى تسجيل الدخول إلى الحساب، وإدارة المفاتيح، وOAuth، وإدارة الشركاء، وعمليات الدفع، وكسر كلمة المرور مقفلة بشكل دائم لكل po_pk_. مسموح بـ APIs الخاصة بالمنتج الموثقة — بما في ذلك حذف POST، والويب هوكس، وقراءة الفواتير، وإدارة علاقات العملاء (CRM).
تسلسل المفاتيح
ثلاثة أنواع من المفاتيح، مسؤوليات واضحة
مفتاح سري للخادم، ومفتاح قابل للنشر للمتصفح — بالإضافة إلى رمز مستخدم للوصول المرتبط بالمستخدم مع حد معدل.
| بادئة | النوع | حالة الاستخدام | آمن للمتصفح | النطاق الافتراضي |
|---|---|---|---|---|
poai_ | مفتاح API | لربط الخوادم ببعضها، بصلاحيات الحساب المنشئ | لا | جميع نقاط النهاية ضمن الخطة والصلاحيات |
po_ut_ | User Token | مستخدم محدد، محدود بالطبقة | لا | قائم على الطبقة |
po_pk_ | Publishable Key | متصفح / لوحة AI (Claude, ChatGPT, Grok) | نعم | قائمة النطاق |
ثلاثة إعدادات مسبقة
نقرة واحدة. مفتاح واحد. هدف واحد.
تم ضبط كل قالب مسبقًا لحالة استخدام محددة — افتراضيات آمنة، نطاقات مختارة بعناية، وميزانيات واقعية. كل شيء قابل للتعديل في أي وقت عبر لوحة التحكم.
-
DEFAULTقراءة آمنةصلاحيات افتراضية آمنة لعروض تجريبية بسيطة وأدوات داخلية: OCR، LLM، ترجمة، مستندات، بحث.
نطاقات الصلاحيات
البدء بهذا القالب -
AIDEMOساحة لعب الذكاء الاصطناعي موصى بهلـ Claude Artifacts، وChatGPT Canvas، وعروض Grok التوضيحية. كل ما تحتاجه لتشغيل عروض الذكاء الاصطناعي مباشرة.
نطاقات الصلاحيات
البدء بهذا القالب -
WIDGETالموقع العاملنماذج الاتصال، وأدوات الدردشة، وأزرار الحجز على موقع شركتكم الخاص.
نطاقات الصلاحيات
البدء بهذا القالب
أول مكالمة لـ API
هل أنت مستعد لإجراء أول استدعاء من المتصفح؟
أنشئوا مفتاحاً، وافتحوا ملف llms-full.txt، والصقوا المطالبة — حيث تتصل تطبيقكم بواجهة برمجة التطبيقات مباشرة من Claude، أو ChatGPT، أو Grok.
بادئة خاصة بدون خادم خلفي قابل للإلغاء في أي وقت
أسئلة شائعة
كل المعلومات المهمة في لمحة
ما الفرق بين po_pk_ و poai_؟
يُستخدم مفتاح API poai_ للتكامل من خادم إلى خادم — ويعمل بصلاحيات الحساب الذي أنشأه ولا ينبغي استخدامه في المتصفح. أما المفتاح po_pk_ (Publishable Key) فهو مصمم خصيصاً لأكواد المتصفح: نطاق محدود، مقيد بالنطاق الأصلي، ومحدد بميزانية. نفس واجهة برمجة التطبيقات، ولكن بملف أمان مختلف.
لماذا لا نستخدم ببساطة وكيل عكسي من الخلفية الخاصة بنا؟
هذا هو النهج الكلاسيكي — لكنه لا يزال يتطلب خادمًا خلفيًا. صُممت الأعمال الفنية للذكاء الاصطناعي (Claude، ChatGPT، Grok) للنشر بدون خادم خلفي. تجعل المفاتيح القابلة للنشر هذا ممكنًا دون كشف مفتاحكم السري: تُفرض الحدود من جانب الخادم.
هل يعمل ذلك في عناصر Claude، على الرغم من صندوق الرمال CORS الخاص بها؟
نعم. يتم تنفيذ الاستدعاء مباشرة من المتصفح، ويضع المتصفح رأس Origin بنفسه. لا تقدم PaperOffice قائمة سماح البائع؛ أدخل الأصل عند إنشاء المفتاح من أدوات المطورين.
ماذا يحدث إذا أصبح po_pk_ الخاص بي مرئياً للجمهور؟
يبقى الضرر محتوى: يمنع قفل الأصل الاستخدام على نطاقات أخرى، ويوقف حد الميزانية الإنفاق، ويبطئ حد المعدل الوصول الآلي. ألغوا المفتاح في حسابكم — بعد ذلك لن تقبله API.
هل يمكنني إضافة نطاقي الخاص إلى قائمة السماح كأصل؟
نعم. عند إنشاء المفتاح تضيفون أي أصل إلى قائمة السماح — كمضيف مطابق تمامًا أو كحرف بدل للنطاق الفرعي. صُمم الإعداد المسبق WIDGET لهذا تحديدًا: سجلوا نطاقكم الخاص وأدمجوا أدوات الدردشة أو الحجز أو الاتصال بدون خادم خلفي.
كيف أضع الميزانية لكل مفتاح؟
عند إنشاء المفتاح، تختارون حداً أقصى مدى الحياة؛ يأتي كل إعداد مسبق مع قيمة افتراضية. بمجرد بلوغ الحد الأقصى، تُعيد واجهة برمجة التطبيقات رمز HTTP 402 BUDGET_EXHAUSTED. يمكنكم تعديل القيمة في حسابكم في أي وقت.
هل يحتاج po_pk_ إلى خطة أسعار خاصة به؟
لا. المفتاح القابل للنشر هو طبقة إضافية حول حسابكم الحالي: فهو يحد من النطاقات، والمصادر، والميزانية. يعرض ملخص التسعير الخطة المناسبة لإعدادكم.
أي نقاط نهاية (Endpoints) مقفلة أمام po_pk_؟
HTTP DELETE بالإضافة إلى تسجيل الدخول إلى الحساب، وإدارة المستخدمين، وإدارة المفاتيح، وOAuth، وإدارة الشركاء، ودفع Stripe، وكسر كلمة المرور مقفلة بشكل دائم. مسموح بـ APIs الخاصة بالمنتج الموثقة، بما في ذلك حذف POST، والويب هوكس، وقراءة الفواتير، والاستيراد، وإدارة علاقات العملاء (CRM). يظل حذف Workspace وتفريغ سلة المهملات وإذن الاحتفاظ القانوني خاصين بالواجهة فقط (403 UI_ONLY_ENDPOINT).
التشغيل والثقة
ما تتحقق منه فرق المؤسسات قبل المكالمة الأولى
العقود، والأمان، والدعم، والحدود، كل الروابط في مكان واحد.
- الأمان والامتثال ISO/IEC 27001 معتمد، بنية تحتية خاصة في الاتحاد الأوروبي.
- اتفاقية مستوى الخدمة (SLA) بنسبة 99.9٪ التوفر الشهري حسب التقويم، مضمون تعاقديًا.
- معالجة البيانات نيابة عن العميل (DPA) عقد معالجة البيانات وفقًا للمادة 28 من اللائحة العامة لحماية البيانات (GDPR).
- لا يوجد معالجون فرعيون مورد واحد للمحرك والتخزين والمعالجة.
- الدعم الفني طريقة مباشرة للوصول إلى فريق الدعم، عبر تذكرة.
- حدود المعدلات والرؤوس القيم الدنيا الموثقة لكل رمز مميز، ورؤوس حد المعدل في كل استجابة.
- الأسعار و Credits أسعار Credits شفافة لكل استدعاء.
المحطة التالية
كيف تستمر
الخطوة التالية الموصى بها في قمع المطورين وفرعان مناسبان.
