إجراء طلبات واجهة برمجة التطبيقات باستخدام Analyzer في Acrobat

تاريخ آخر تحديث 13‏/10‏/2026

حدد نقطة النهاية الإقليمية لواجهة برمجة التطبيقات الخاصة بالمؤسسة، وصادق على طلباتك، واستخدم المحلل في واجهات برمجة تطبيقات Acrobat.

قبل استدعاء واجهات برمجة تطبيقات المحلل، حدد نقطة وصول واجهة برمجة التطبيقات الخاصة بالمؤسسة.يدعم المحلل حاليًا منطقتي NA1 و EU1.

قبل البدء

أكمل إعداد وصول واجهة برمجة التطبيقات للمحلل في Acrobat واحصل على رمز وصول صالح لـ OAuth Server-to-Server.

حدد نقطة النهاية الإقليمية لواجهة برمجة التطبيقات

يستخدم المحلل نقطة النهاية baseUris لتحديد نقطة الوصول الإقليمية لواجهة برمجة التطبيقات الخاصة بالمؤسسة.

نقطة النهاية baseUris متاحة من خلال NA1 فقط.استدعِ نقطة نهاية NA1 حتى لو كانت المؤسسة مستضافة في EU1.

أرسل طلب GET مصادق عليه إلى نقطة النهاية baseUris الخاصة بالمحلل:

اقرأ قيمة apiAccessPoint من الاستجابة.

تحدد الاستجابة نقطة النهاية الإقليمية لواجهة برمجة التطبيقات المخصصة للمؤسسة.

{
"apiAccessPoint": "[نقطة النهاية الإقليمية لواجهة برمجة تطبيقات المحلل]"
}

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

احرص على تحديد نقطة وصول واجهة برمجة التطبيقات الخاصة بالمؤسسة دائمًا من خلال baseUris بدلاً من ترميز نقطة نهاية إقليمية بشكل ثابت.

صادق على طلبات واجهة برمجة التطبيقات

مرر رمز الوصول OAuth Server-to-Server في رأس Authorization لكل طلب من طلبات واجهة برمجة التطبيقات:

Authorization: Bearer <access_token>

أنشئ طلبات واجهة برمجة التطبيقات اللاحقة باستخدام apiAccessPoint المُعادة بواسطة baseUris.

استخدم مرجع واجهة برمجة التطبيقات

يوفر المحلل واجهات Swagger إقليمية لاستكشاف نقاط النهاية والمعاملات وأنماط الطلبات والاستجابات والعمليات المدعومة.

استخدم واجهة Swagger الخاصة بمنطقة المؤسسة:

  • NA1: https://analyzer-na1.adobe.io/swagger-ui/index.html
  • EU1: https://analyzer-eu1.adobe.io/swagger-ui/index.html

اعتمد جلسة Swagger برمز الوصول OAuth Server-to-Server صالح قبل اختبار نقاط النهاية المصادق عليها.

عمليات واجهة برمجة التطبيقات المتاحة

استخدم واجهة برمجة التطبيقات الخاصة بـ Analyzer لـ:

  • رفع المستندات للمعالجة.
  • البحث في المستندات وتصفيتها.
  • استرداد حالة معالجة المستند.
  • استرداد الخصائص المتاحة.
  • استرداد قيم الخصائص المستخرجة.

راجع واجهة Swagger الإقليمية لمسارات نقاط النهاية والمعاملات ومخططات الطلبات ومخططات الاستجابات ورموز الحالة.

الخطوة التالية

إذا كانت عملية التكامل الخاصة بك تحتاج إلى الوصول إلى بيانات Analyzer للمستخدمين الأفراد، راجع تكوين الوصول نيابة عن المستخدم لـ Analyzer في Acrobat.