لماذا تستخدم مجموعة Postman من Certyneo
تم تصميم المجموعة للمطورين الذين يريدون استكشاف واجهة برمجة Certyneo دون قراءة كل التوثيق قبل إطلاق طلبهم الأول.
طلبات جاهزة للاستخدام
كل نقطة نهاية في API REST v1 موثقة مع مثال على الطلب والاستجابة، جاهزة للتنفيذ بعد إدخال مفتاح API الخاص بك.
بيئات الاختبار
متغير بيئة Postman يحتوي على مفتاح API الخاص بك وعنوان URL الأساسي، للتبديل بسهولة بين حساباتك أو بيئاتك.
الوثائق المُنشأة تلقائياً
تبقى وثائق Postman لمجموعة البيانات متزامنة مع مواصفات OpenAPI لـ API Certyneo — بدون فجوة بين ما تختبره وما يكون في الإنتاج.
الاختبار بدون كتابة أكواد
أنشئ ظرفاً، أرسله وتابع حالته مباشرة من واجهة Postman، حتى قبل دمج API في تطبيقك.
ما تغطيه المجموعة
نظرة عامة على مجموعات نقاط النهاية المتاحة في المجموعة العامة.
| المجموعة | ما تحتويه |
|---|---|
| الأظرف | إنشاء ظرف التوقيع وإرساله وإدراج قوائمه والاستعلام عنه وإلغاؤه. |
| المستندات | تحميل مستند أو استيراده من عنوان URL (sourceUrl)، الاستعلام عن حالته. |
| الموقّعون | إضافة المتلقين وتحديد ترتيب التوقيع والمستوى الخاص بهم (SES/AES). |
| Webhooks | إنشاء وإدارة الاشتراكات في أحداث التوقيع. |
| الإرسال الجماعي | إرسال عدة أظرف في طلب واحد لحملات التوقيع بالحجم الكبير. |
المجموعة متاحة للقراءة العامة: يمكنك الاطلاع عليها بدون حساب، لكن تنفيذ الاستعلامات يتطلب مفتاح API صحيح لـ Certyneo.
البدء مع المجموعة في 4 خطوات
يستغرق الأمر أقل من 5 دقائق لتشغيل استعلامك الأول.
- 1
استيراد المجموعة العامة
من Postman، افتح مجموعة Certyneo العامة وانقر على "Fork" أو "Import" لنسخها إلى مساحتك الخاصة.
- 2
توليد مفتاح API لـ Certyneo
في لوحة تحكم Certyneo الخاصة بك، افتح الإعدادات → مفاتيح API وأنشئ مفتاحاً مخصصاً لـ Postman.
- 3
ملء متغير البيئة
الصق مفتاح API الخاص بك في متغير البيئة الخاص بمجموعة Postman، بالإضافة إلى عنوان URL الأساسي للـ API.
- 4
إرسال الاستعلام الأول
شغّل الاستعلام "إنشاء ظرف" واتبع النتيجة مباشرة في Postman.
الأمان والممارسات الجيدة
طلبات المجموعة تمر عبر نفس API الخاص بتطبيقك في الإنتاج: تنطبق نفس قواعد الأمان.
- جميع الطلبات تنتقل عبر HTTPS/TLS 1.2 كحد أدنى.
- كل مفتاح API مقيد بالأذونات التي تمنحها له عند إنشاؤه.
- استخدم مفتاح اختبار مخصصاً لمحاولاتك في Postman، منفصلاً عن مفتاح الإنتاج الخاص بك.
- يمكن إلغاء مفتاح API المكتشف أو غير المستخدم برقة واحدة من لوحة تحكم Certyneo الخاصة بك.
الأسئلة الشائعة
هل تحتاج إلى خطة مدفوعة لاستخدام مجموعة Postman؟
لا. المجموعة عامة ومجانية. حدود خطتك Certyneo (عدد المغلفات والميزات) تنطبق على الطلبات المنفذة، تماماً كما هو الحال مع أي استخدام آخر للـ API.
أين أجد مفتاح API الخاص بي؟
في لوحة تحكم Certyneo الخاصة بك، تحت الإعدادات → مفاتيح API. أنشئ مفتاحاً مخصصاً لاختبارات Postman الخاصة بك.
هل المجموعة محدثة مع أحدث إصدار من API؟
نعم، يتم إعادة إنشاء المجموعة من مواصفات OpenAPI الرسمية لـ API Certyneo مع كل تطور في REST API v1.
هل يمكنني اختبار webhooks من Postman؟
نعم، تحتوي المجموعة على نقاط النهاية لإنشاء وإدراج اشتراكات webhooks الخاصة بك. لتلقي الأحداث محلياً، استخدم خدمة نفق HTTP أثناء الاختبارات.
هل لاستخدام مجموعة Postman تكلفة؟
لا، يتم خصم استهلاك API نفسه فقط (إنشاء المغلفات) من خطتك، تماماً مثل استدعاء API تقليدي.
للذهاب إلى أبعد من ذلك
اختبر API Certyneo في Postman
مجموعة عامة ومجانية ومتزامنة مع وثائق المطورين الخاصة بنا.