مين محتاج API؟
- عندك متجر Shopify وعايز يزامن مع مخزون ميزان
- عندك تطبيق موبايل خاص وعايزه يقرا الطلبات
- محاسبك عايز يجيب تقارير جاهزة لبرنامجه
- شركة شحن عايزة تتبع الطلبات لحظياً
الـ Endpoints المتاحة (v1)
- GET /api/v1/products
- GET /api/v1/customers
- GET /api/v1/orders
- GET /api/v1/invoices/purchase
- GET /api/v1/reports/{trial-balance, profit-loss, balance-sheet, vat}
- POST /api/v1/orders (لو write_orders مفعّل)
الأمان أولاً
- مفاتيح API بتتخزن كـ SHA-256 hash (المفتاح كامل يظهر مرة واحدة عند الإنشاء بس)
- Rate limiting شبه sliding window، افتراضي 60 طلب/دقيقة
- كل طلب بيتسجّل في api_request_log
- Scoped keys: تقدر تحدد المفتاح ده يقرا إيه بالظبط
مثال Curl
curl -H "Authorization: Bearer mzn_YOUR_KEY" \
https://shop.example.com/api/v1/products?limit=10
