وثائق المطوّرين

ابدأ ستور منصّة لإنشاء المتاجر الإلكترونية للتجّار في مصر. كل متجر يعمل على <اسم-المتجر>.ebda.app أو على دومين خاص، وكله مبني على واجهة برمجة واحدة على https://api.ebda.app/api/v1.

الوثائق التفصيلية مكتوبة بالإنجليزية لأنها موجّهة للمطوّرين. هذه الصفحة تلخّص أهم النقاط:

• المبالغ بالقروش. كل سعر في الواجهة رقم صحيح بالقرش (100 قرش = 1 جنيه)، ولا توجد أسعار عشرية أبداً.
• المصادقة. واجهة المتجر العامة لا تحتاج تسجيل دخول لكنها تحتاج تحديد المتجر عبر الهيدر x-store-domain. أما الواجهات الإدارية فتستخدم رمز وصول، ومفاتيح التاجر (x-merchant-key) للأتمتة.
• الويب هوكس. يتم التحقق من التوقيع على البايتات الخام للطلب، ويُمنع تكرار المعالجة.
• حدود الاستخدام. تُرجع الواجهة الحالة 429 عند تجاوز الحد، ويُقفل الحساب 15 دقيقة بعد 5 محاولات دخول فاشلة.

ابدأ من الروابط التالية:

• Getting started

  Make your first Ebda Store API call in a few minutes.

• Authentication

  Access tokens, how public endpoints find the store, and merchant API keys with scopes.

• Hosts and domains

  The Ebda Store hosts, store subdomains, custom domains and reserved names.

• Money and currency

  All amounts are integers in piastres. EGP has two decimals.

• Rate limits

  The limits the API enforces, how a limited request looks and how to back off.

• Webhooks

  Payment and billing webhooks, signature verification, idempotency and what status codes mean.

• Public storefront API

  Unauthenticated storefront endpoints for catalogue, categories and cart.

• Merchant API

  Authenticated store-management endpoints and the merchant admin MCP surface.

• Merchant webhooks

  Receive signed order and product events on your own server, verify them, and handle retries.