دليل API لنقاط البيع وERP
اربط أنظمتك
أنشئ مفتاحاً من لوحة ربط التاجر وحدد قراءة المنتجات أو كتابتها أو قراءة الطلبات. احفظ المفتاح في إعدادات خادم نظامك الخارجي.
إنشاء مفتاح APIتحميل مواصفات OpenAPIالطلبات
Authorization: Bearer aswaq_api_YOUR_KEY
GET https://aswaqos.com/api/v1/products?limit=100
GET https://aswaqos.com/api/v1/orders?limit=100
POST https://aswaqos.com/api/v1/products
Content-Type: application/json
{"products":[{"sku":"YOUR-SKU","name":"Your product","price":"12.500","stock":20,"unit":"item","currency":"AED"}],"replace_stock":false}تعيد الاستجابة مؤشر next عند وجود سجلات إضافية؛ مرره كقيمة after. الأسعار بعملة المتجر دون تحويل تلقائي. الكتابة حتى ١٠٠ منتج لكل طلب. يبقى المخزون الحالي إلا إذا اخترت replace_stock=true؛ يُمنع استبداله أثناء وجود طلبات مفتوحة.
يتضمن تصدير الطلبات المبالغ والحالات والبنود دون أسماء العملاء أو هواتفهم أو عناوينهم. الحد ١٢٠ طلباً لكل مفتاح في الدقيقة. يسري إلغاء المفتاح فوراً.
أحداث الطلبات الموقعة
حدد مستقبلاً عبر HTTPS ورمزاً مشتركاً. تحقق من HMAC-SHA256 لقيمة timestamp + "." + نص الطلب الأصلي. ارفض الأوقات القديمة وامنع تكرار X-AswaqOS-Delivery. تعني استجابة 2xx القبول؛ تحقق من المعالجة لدى المستقبل. تبقى الأحداث الفاشلة متاحة لإعادة المحاولة.
X-AswaqOS-Delivery: event-identifier
X-AswaqOS-Timestamp: unix-seconds
X-AswaqOS-Signature: sha256=hex-signature
Events: order.created, order.status_changed
Payload: {id,event,created_at,data}