API برنامج الولاء للكاشير أو تطبيقك
أضف أختام أو نقاط أو استرداد نقدي من الكاشير أو تطبيقك، وبطاقة العميل في Apple Wallet أو Google Wallet تتحدّث بنفسها.
وش تقدر تسوي تلقائياً
- الانضمام: افتح بطاقة لعميل جديد من رقم جواله.
- الأختام: أضف ختم بعد البيع، أو ألغِ آخر ختم.
- النقاط والاسترداد النقدي: أعطِ نقاط حسب المبلغ، بقواعد محلك.
- ابحث عن عميل: لاقِ البطاقة برقمها أو بجوال العميل، واقرأ الأختام والنقاط والمكافآت.
- الاستبدال: أعطِ المكافأة لما تكتمل البطاقة، أو اصرف النقاط.
- API الكاشير: أرسل الطلبات المدفوعة والمرتجعات، والأختام أو النقاط تمشي حسب نوع بطاقة المحل. وهذا اللي تستخدمه تطبيقات Odoo.
مفاتيح API
- صاحب المحل يسوي المفاتيح من صفحة مفاتيح API في لوحة التحكم، والمفتاح يظهر مرة وحدة.
- تقدر تلغي أي مفتاح أي وقت، وتقدر تحط له تاريخ انتهاء.
- كل مفتاح يشتغل لمحله بس.
- ترسله في ترويسة Authorization: Bearer sip_…
ثلاث أنواع مفاتيح
- full: الـ API كامل، للكاشير أو تطبيقك. باقة الأعمال
- pos: API الكاشير بس (/api/pos)، لـ Odoo. باقة الأعمال
- solver: فواتير Solver بس، للعيادات. أي باقة مع إضافة Solver
طلب واحد: أضف ختم
كل طلب يرسل المفتاح كـ Bearer token ويرجع له JSON. وتوثيق الـ API فيه كل الطلبات مع معاملاتها ومثال.
curl -X POST https://sipcard-production-b91a.up.railway.app/api/stamp -H "Authorization: Bearer sip_…" -H "Content-Type: application/json" -d '{"cardId": "c7f1…"}'
حدود الطلبات
كل طلب له حد بالدقيقة. مفتاح API الكاشير يقدر يرسل 120 طلب بالدقيقة. وإذا تعدّيت الحد، الـ API يرد 429: انتظر دقيقة وأرسل مرة ثانية.
باقة الأعمال
مفاتيح API تجي مع باقة الأعمال. وإذا خلصت الباقة أو نزلت لباقة أصغر، المفاتيح توقف لين ترجع. والعيادات اللي تستخدم Solver HMIS تقدر تستخدم مفتاح Solver مع أي باقة بالإضافة.
أسئلة شائعة
كيف أسوي المصادقة؟
سوّ مفتاح من صفحة مفاتيح API وأرسله في ترويسة Authorization بصيغة Bearer sip_…، والردود ترجع JSON.
أي باقة فيها الـ API؟
باقة الأعمال، من 35 ر.ع. في الشهر بالدفع السنوي (50 ر.ع. بالدفع الشهري). والعيادات تقدر تستخدم مفتاح Solver مع أي باقة بإضافة Solver، بـ 12 ر.ع. في الشهر.
أقدر أربط Odoo بدون برمجة؟
أكيد. ثبّت تطبيق NuqtaPass المجاني لـ Odoo والصق المفتاح، وهو يستخدم API الكاشير عنك.
وإذا انكشف المفتاح؟
ألغه من صفحة مفاتيح API وسوّ مفتاح جديد للكاشير. وكل مفتاح يوصل لمحلك بس.
فيه حد للطلبات؟
إيه، كل طلب له حد بالدقيقة. مفتاح API الكاشير يقدر يرسل 120 طلب بالدقيقة. وإذا تعدّيت الحد يجيك رد 429: انتظر دقيقة وأرسل مرة ثانية.