Skip to main content
لا توفر AceDataCloud حاليًا نقطة نهاية مجمّعة /api/v1/distribution/. تتكون بيانات مكافآت الإحالة من أربع مجموعات من الواجهات: الحالة، والسجل، والمستوى، والاستبدال؛ يرجى استدعاؤها وفقًا للموارد المطلوبة، وتجنب الاعتماد على استجابة ملخصة غير موجودة.

​
التحضير

  1. أنشئ واحفظ Account Token في لوحة تحكم Account Token.
  2. استخدم GET /api/v1/platform-tokens/me/ للحصول على UUID للحساب الحالي.

​
الواجهات المتاحة

​
أمثلة على طلبات القراءة فقط

شكل الاستجابة الذي تم التحقق منه في بيئة الإنتاج هو:
  • status وhistory وlevel وredemption list: {count, items}؛
  • redemption preview: كائن واحد، يتضمن حقولًا مثل eligible وreason وreward_amount وcredit_amount وcredits_per_usd وcurrency وpackage وglobal_application.
قد تتوسع عناصر الحالة والسجل وفقًا لضوابط مخاطر الإحالة والتعويضات وقواعد المكافآت؛ ينبغي للعميل قراءتها عند الحاجة، وألا يعتمد على حقول مجمّعة مثل referral_url وrecent_orders وwithdrawable_balance غير المُعادة من الواجهة في الوثائق القديمة.
كل من التهيئة والاستبدال عمليتا كتابة. يجب أن تستدعي نصوص الإنتاج واجهات القراءة فقط أولًا للتحقق من الحالة، وأن تحفظ idempotency_key فريدًا لطلب الاستبدال؛ لا تعِد المحاولة تلقائيًا لاستبدال ذي نتيجة غير معروفة.

​
الصفحات ذات الصلة

​
طلبات تسعير الزيادة للمواقع الفرعية

بالنسبة لطلبات المواقع الفرعية التي تنطبق عليها القواعد الجديدة، تُحسب عمولة الإحالة على أساس السعر الأساسي بعد الخصم، ويعود كامل فرق الزيادة بعد الخصم إلى مدير الموقع عند إنشاء الطلب. تُدمج جزأا المكافأة للمستفيد نفسه في سجل التوزيع الأصلي، ويعرض سجل التوزيع مكوّناتها؛ أما الطلبات دون زيادة سعر والطلبات التاريخية فتبقى خاضعة للقواعد الأصلية. على سبيل المثال، إذا كان السعر الأساسي 100 والسعر بعد الزيادة 120، وكان مدير الموقع هو المُحيل الوحيد أيضًا وكانت النسبة 10%، فإن مكافأة هذا الطلب هي 10 + 20 = 30. وإذا لم يكن مدير الموقع والمُحيل الشخص نفسه، يحصل كل منهما على المكافأة المقابلة له. تظل التسوية النقدية تُنفذ يدويًا بواسطة المنصة. تُجري المنصة الدفع اليدوي بعد خصم المبلغ المتاح لهذه المرة من حساب المكافآت الأصلي؛ ولا يمكن دفع الأجزاء التي تم استبدالها بالفعل بنقاط نقدًا مرة أخرى. وإذا ظهر عجز في المكافآت بعد الاسترداد، فسيتم خصمه أولًا من المكافآت اللاحقة.