اربط برامج أخرى بمفتاح API

ما تحتاجه أولاً

• دخول صاحب المتجر (أو حساب مسموح له بدخول الإعدادات).
• البرنامج الآخر، أو المبرمج الذي يجهّزه، جاهز للصق المفتاح.

الخطوات

1. 1

   افتح الإعدادات ← البيانات وواجهة API.

2. 2

   اكتب اسماً يوضح لمن المفتاح (الموقع، المحاسب…) واضغط إنشاء مفتاح.

3. 3

   اضغط نسخ والصق المفتاح في البرنامج الآخر فوراً. يظهر مرة واحدة فقط — سهل يحتفظ بنسخة مشفّرة ولا يستطيع إظهاره مرة أخرى.

4. 4

   يرسل البرنامج المفتاح مع كل طلب، في الترويسة Authorization: Bearer يليها المفتاح. مثال: طلب إلى https://getsahel.com/api/v1/products يعيد كل المنتجات مع السعر والمخزون، الإجمالي ولكل فرع. المبيعات على /api/v1/sales (أضف ?from=2026-10-01&to=2026-10-31 لفترة محددة) والعملاء على /api/v1/customers.

5. 5

   القوائم تأتي 50 في كل مرة (حتى 200 مع ?limit=200). ما دام الرد يقول has_more: true، اطلب مجدداً مع ?offset= مُزاداً بنفس العدد.