واجهة Saff البرمجية — حوّل المستندات إلى بيانات من داخل نظامك
واجهة REST وإشعارات موقّعة لتحويل ملفات PDF والمسوحات والصور إلى صفوف بالأعمدة التي تحددها. بنفس سعر المستند في التطبيق.
كيف يعمل التكامل
عرّف الجدول مرة واحدة
سمِّ الحقول التي تريدها وأنواعها. كل مستند يُرسل مقابل هذا الجدول يعود بهذه الأعمدة وبهذا الترتيب.
افتح دفعة وارفع الملفات
استدعاءان. كلاهما يأخذ مفتاح عدم تكرار، فالطلب الذي تنتهي مهلته يمكن إعادته بأمان بدل أن يُحتسب مرتين.
اعرف متى ينتهي
إشعار موقّع يحمل المعرّفات والحالة فقط — لا قيماً مستخرجة ولا محتوى مستندات. وتجلب ما تحتاجه بالمفتاح الذي لديك.
اقرأ الصفوف
JSON يحمل القيمة، ودرجة الثقة، والدليل الذي جاءت منه، وما إذا صحّحها أحد بعد ذلك.
ما تمنحه الواجهة ولا تمنحه نقطة تحويل عادية
أعمدتك، لا أعمدة المستند
المخرجات هي الجدول الذي عرّفته. مورّدان بتخطيطَي فاتورة مختلفين ينتجان الشكل نفسه، فلا يحتاج ما بعدهما إلى تفرّع لكل مورّد.
الثقة والدليل
كل قيمة تذكر درجة ثقتها وموضعها في الصفحة، ليتمكن كودك من تحويل المشكوك فيه إلى شخص.
كتابة غير متكررة
كل عملية كتابة تأخذ Idempotency-Key. تكرار الطلب يعيد النتيجة الأولى بدل أن يُنفَّذ مرتين، فإعادة المحاولة بعد انتهاء المهلة آمنة.
مفاتيح محدودة الصلاحية
يحمل المفتاح ما تمنحه فقط، ويمكن حصره في جداول بعينها. تكامل للقراءة لا يستطيع الإرسال أو الحذف.
ويمكن الوصول إليه من مساعد ذكي
يتحدث Saff بروتوكول MCP، فيستطيع ChatGPT أو Claude قراءة الجداول التي توافق عليها والإجابة عن نتائج لديك بالفعل. هذا الاتصال للقراءة فقط، ولا يكلّف شيئاً، وهو منفصل عن الواجهة البرمجية: لا يستطيع المساعد الإرسال أو التعديل أو التصدير.
التكلفة
نفس سعر المستند في التطبيق، ومن المحفظة المدفوعة مسبقاً نفسها. لا خطة منفصلة للواجهة، ولا رسوم لكل مقعد، ولا حد أدنى. الاستخراج عبر الواجهة يستهلك الرصيد فقط، ولا يمسّ المستندات المجانية الشهرية.
ما لا تفعله
لا تَعِد بالدقة. القيم غير المؤكدة تعود مُعلَّمة بدل أن تُخمَّن، وقد تعود خلايا فارغة من الخط اليدوي أو المسوحات الرديئة. والتكامل الذي يُدخل النتائج في دفتر حسابات دون فحص هذه العلامات يستخدمها استخداماً خاطئاً.
وليست أداة تحرير PDF: لا دمج ولا تقسيم ولا توقيع ولا تحويل إلى Word — تقرأ المستندات إلى حقول، لا أكثر.
أين المرجع الكامل؟
داخل مساحة عملك، ضمن التكاملات. يسرد كل نقطة نهاية، والصلاحية التي تحتاجها، وأمثلة الطلبات — وهو خلف تسجيل الدخول لأنه مكتوب لمن يحمل مفتاحاً بالفعل.
هل تحتفظون بالمستندات التي أرسلها؟
لا تُحفظ الملفات الأصلية بعد المعالجة إلا إذا ربطت مساحة العمل مخزنها الخاص. والقيم المستخرجة والتصحيحات مشفّرة في التخزين، ولا تُستخدم لتدريب أي نظام استخراج.
كيف أتحقق أن الإشعار جاء من Saff فعلاً؟
كل تسليم موقّع. تحقق من التوقيع مقابل جسم الطلب الخام قبل تحليله، وارفض كل ما مضى عليه أكثر من خمس دقائق. وفي المرجع مثال كامل.
ماذا يحدث إذا فشل مستند؟
يصلك إشعار بذلك ولا يُحتسب المستند. الفشل حالة يمكنك التصرف بناءً عليها، لا فجوة صامتة في المخرجات.
ابنِ عليها
أنشئ حساباً، وعرّف جدولاً، وأصدر مفتاحاً من التكاملات. المستندات الأولى مجانية ولا حاجة إلى بطاقة للتجربة.