البداية السريعة ومجموعة Postman

مجموعة Postman

الإعدادات ← التكامل ← تبويب Postman ← تحميل: ملف zip (المجموعة v2.1 + ملف البيئة + README.md) — 4 مجلدات و10 طلبات، مصادقتها بمتغيّر {{api_key}} وعنوانها {{base_url}}. لا أسرار داخلها. تُبنى من الكود لحظة التحميل فهي دائمًا مطابقة لإصدارك.

بعد الاستيراد في Postman: اضبط base_url بعنوان التنصيبة وapi_key بمفتاحك. لا OpenAPI/Swagger في الإصدار الحالي.

وتبويب الدليل العام يعرض داخل البرنامج ملخّص ما في هذا القسم لمن لا يملك الرابط:

السيناريو الكامل (Dynamics)

المسار المباشر (بلا Dynamics)

الخطوات 1→3 ثم POST /api/cheque-log/external — راجع إنشاء شيك مباشرة. لا معاينة ولا طباعة ولا صورة (إلا بـsave_cheque_image: true مع image_base64).

نموذج طلب كامل

# 1) البنوك
curl -s -H "X-API-KEY: KEY" -H "Accept: application/json" "APP_URL/api/banks"
# 2) نماذج البنك 2
curl -s -H "X-API-KEY: KEY" -H "Accept: application/json" "APP_URL/api/banks/2/templates"
# 3) إنشاء مباشر
curl -s -X POST "APP_URL/api/cheque-log/external" \
  -H "X-API-KEY: KEY" -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"bank_name":"بنك مصر","template_name":"بنك مصر - نموذج 1","cheque_type":"OUT",
       "recipient_name":"شركة النيل للتوريدات","amount":1250.50,"currency":"EGP",
       "cheque_date":"2026-10-15","cheque_number":"100200","reference_number":"PV-1001"}'

قائمة تحقق قبل الإنتاج

• مفتاح بتاريخ انتهاء وحدّ معدل مناسب، ومحفوظ في خزانة أسرار نظامك.
• الترويسة X-API-KEY لا الرابط.
• مفتاح لكل شركة — ولا ترسل مراجع من شركة أخرى.
• template_id لا الاسم.
• cheque_number دائمًا، ومعالجة 422 «مستعمَل بالفعل».
• Dynamics: external_id دائمًا، save_cheque_image: true إن أردت الصورة، callback على HTTPS.
• مراقبة «سجل API» أسبوعيًا.

صفحات ذات صلة

• مفاتيح API
• مرجع الأخطاء
• Dynamics — التدفّق