نقاط البنوك والنماذج — GET /api/banks و/api/bank-templates

GET /api/banks

الغرض: البنوك النشطة التي لها نماذج — لاختيار bank_id أو bank_name.

curl -s -H "X-API-KEY: KEY" -H "Accept: application/json" "APP_URL/api/banks"

200 — مصفوفة JSON عارية من صفوف البنك كاملة مع logo_url:

[
  { "id": 2, "name": "بنك مصر", "name_en": "BM", "status": 1,
    "logo": "uploads/banks/bm.png", "logo_url": "https://…/uploads/banks/bm.png", "…": "…" }
]

قيود:

• البنك يظهر إن كان نشطًا وله نموذج واحد على الأقل — ولو كانت نماذجه كلها معطَّلة؛ تحقّق من النماذج بالنقطة التالية.
• الردّ يحمل أعمدة داخلية (is_official · official_key · official_version · is_modified · note · deleted_at) — تجاهلها؛ ليست جزءًا من العقد.
• بلا صف تدقيق، وبلا فلتر شركة (البنوك بيانات التنصيبة كلها).

GET /api/bank-templates وGET /api/banks/{bankId}/templates

الغرض: النماذج — كلها، أو لبنك بعينه — لاختيار template_id/template_name.

curl -s -H "X-API-KEY: KEY" -H "Accept: application/json" "APP_URL/api/banks/2/templates"

200 — مصفوفة بإسقاط صريح بهذه المفاتيح بالترتيب:

[
  { "id": 5, "bank_id": 2, "bank_name": "بنك مصر", "bank_name_en": "BM",
    "name": "بنك مصر - نموذج 1", "currency": "EGP", "with_stub": true, "featured": true,
    "status": 1, "logo": "…", "image": "…", "logo_url": "…", "image_url": "…",
    "size_position": { "…": "…" } }
]

قيود:

• bankId مجهول ⟹ 200 بمصفوفة فارغة لا 404.
• بلا صف تدقيق.

الاستعمال الصحيح

1. GET /api/banks ← اختر البنك.
2. GET /api/banks/{id}/templates ← اختر template_id (النشط فقط يعود).
3. مرّر template_id في الإنشاء أو التحضير — أدقّ من الاسم.

صفحات ذات صلة

• إنشاء شيك مباشرة
• Dynamics — الحقول والنموذج
• نماذج الشيكات