مجموعة Postman

تأتي كل عقد مزوَّدة بمجموعة Postman مُهيأة مسبقًا بعناوين URL لـ sandbox ونماذج لأجسام الطلبات. استورد المجموعة، وأدخل بيانات الاعتماد الخاصة بك، ويمكنك استدعاء كل نقطة نهاية دون كتابة أي كود.

المجموعات حسب العقد

العقد	المجموعة	ملاحظات
المصادقة	تنزيل	نزّل الملف أدناه، استورده في Postman، واستبدل قيم المعاملات "service_account" و"tenant_id" و"secret_key" لاختبار الطلب.
Web & SDK	تنزيل	يتضمن إنشاء العملية، GET process، GET evidences، وGET PDF.
API	تنزيل	يتضمن إنشاء العملية (POST) وGET process.

الإعداد

1. نزّل المجموعة للعقد الذي تقوم بتكاملها.
2. استورد المجموعة في Postman: File > Import > Upload Files.
3. قم بتكوين بيانات الاعتماد بحسب المجموعة:

المصادقة — افتح المجموعة، انتقل إلى تبويب Variables، وأدخل:

المتغير	القيمة
service_account	اسم حساب الخدمة الخاص بك.
tenant_id	معرف المستأجر الخاص بك.
secret_key	مفتاحك الخاص (بصيغة PEM).
base_path	مضيف نقطة نهاية الرمز. الافتراضي UAT (https://identityhomolog.acesso.io)؛ غيّره إلى https://identity.acesso.io للإنتاج.

Web & SDK — افتح كل طلب واستبدل قيمة Authorization: Bearer برمزك الخاص.

API — افتح كل طلب واستبدل قيمتَي ترويسة Authorization: Bearer وAPIKEY ببيانات الاعتماد الخاصة بك.

4. شغّل طلب المصادقة — يقوم سكريبت ما قبل الطلب تلقائيًا ببناء تأكيد JWT وتخزينه في {{jwt_token}}.

سكريبتات ما قبل الطلب

فقط مجموعة المصادقة تتضمن سكريبت ما قبل الطلب. يقوم بما يلي:

• قراءة service_account وtenant_id وsecret_key وbase_path من متغيرات المجموعة.
• بناء وتوقيع تأكيد JWT (RS256) باستخدام مكتبة KJUR المدمجة.
• حفظ الرمز الموقَّع في {{jwt_token}}، الذي يُحقن في جسم الطلب تلقائيًا.

مجموعتا Web & SDK وAPI لا تحتويان على سكريبتات ما قبل الطلب — يتم تعيين بيانات الاعتماد مباشرة في ترويسات الطلب.

ما التالي

• المصادقة — أنشئ بيانات الاعتماد التي تحتاجها المجموعة.
• نظرة عامة على Web & SDK — السياق لمجموعة Web & SDK.
• نظرة عامة على API — السياق لمجموعة API.