سجل التغييرات

كل تغيير متوافق مع الإصدارات السابقة يُضاف إلى v1. التغييرات الكاسرة تدخل في إصدار جديد (v2) مع مهلة إيقاف لا تقل عن ستة أشهر يُعلَن عنها هنا.

٢٠٢٦-٠٧-١٧ — endpoint لاختبار الاتصال، مستقبِل Webhooks لكل بيئة، X-TenantId

• اختبار اتصال صريح جديد: GET /api/partner/v1/connection يعيد اسم متجر التاجر والمنصة والبيئة المستهدفة — اعرض الاسم بصيغة «متصل بـ …» للتأكد من الحساب الصحيح. راجع دليل البدء.
• أُزيل GET /api/partner/v1/stores — كان موجوداً فقط كاختبار اتصال ضمني، وبيانات فروعه مكررة مع GET /branch-mappings. أُزيل قبل أن يبني أي شريك عليه.
• روابط استقبال الـ Webhooks تُسجَّل الآن لدى قروش مرة واحدة لكل بيئة (اختبارية وإنتاجية) عند تأسيس الشراكة — التاجر لم يعد يُدخل أي رابط. عند التفعيل يختار التاجر البيئة ويُدخل معرّف حسابه على منصتك.
• كل تسليم webhook يحمل الآن header X-TenantId ليتمكن المستقبِل المشترك من توجيه الحدث إلى الحساب الصحيح. راجع Webhooks.
• يبدأ تسليم الـ Webhooks الآن فقط بعد أول POST /events موقّع منك — التفعيل يُصدر مفاتيح الربط لكنه يحجب التسليم الصادر حتى تُثبت أنك تملك السر الموقِّع. الأحداث التي تنشأ في هذه الأثناء تُحفظ في قائمة الانتظار ولا تُفقد. راجع Webhooks.

٢٠٢٦-٠٧-١٦ — البحث عن العميل + مراجعة دقة الوثائق

• endpoint جديد للبحث عن العميل — GET /api/partner/v1/customers/lookup — يُعيد الرصيد والمستوى والمكافآت القابلة للاسترداد وتقدّم الأختام عند الدفع.
• أحداث InvoiceEarned تحتسب النقاط والأختام من البداية للنهاية، مع رموز معالجة الأحداث لحالات فشل الكسب.
• كل endpoint وحدث وآلية موسومة الآن بـ متاح أو مُخطط. تم توضيح أن /events يمنع التكرار على eventId (لا حاجة لـ Idempotency-Key اليوم) وأن كتالوج الويبهوك يحمل حالياً LoyaltyRuleChanged وIntegrationStatusChanged.
• تصحيح مرجع رموز أخطاء الشركاء لتطابق رموز الاتصال الفعلية بالضبط.

٢٠٢٦-٠٧-١٥ — v1.0

• الإصدار العام الأول.
• Endpoint استقبال الأحداث POST /events.
• فلتر Idempotency مع تخزين ٢٤ ساعة.
• تسليم Webhooks موقّع بـ HMAC مع إعادة محاولة بتباعد أُسّي.
• بيئتا اختبار وإنتاج.