المفاهيم
خزائن المكافآت
نسخ الصفحة
Lia يمكن أن تدعم خزنة من $LIA لتطبيقك. تدفع خادمك اللاعبين منها مرة واحدة لكل مكافأة، داخل الخزنة والحد اليومي لكل لاعب.
#ماذا هي مجموعة المكافآت
مصدر المكافأة هو $LIA الفريق Lia يخصصه لتطبيقك من Lia'صندوق الخزينة. تدفع لاعبيك من خلاله: للفوز ببطولة، إنهاء مهمة، مشاهدة فيديو، أي شيء يقرره تطبيقك. يذهب $LIA مباشرة إلى اللاعب'رصيده في Lia، ويظهر في نشاطهم تحت تطبيقك'اسمها مع السبب الذي تقدمه.
فريق الـ Lia يقرر ما إذا كان تطبيقك لديه حوض، ويقوم بتمويله، ويمكنه إضافته أو استرداده. اسألهم عن حوض عندما يقول لك مسبقًا..
#دفع مكافأة
يُحدث خادمك POST /rewards مع مفتاحك السري:
{
"playerId": "p_3f9c0a6d1b2e4f5a6b7c",
"amount": 25,
"key": "tournament-2026-11-01:p_3f9c0a6d1b2e4f5a6b7c",
"reason": "Weekly tournament, 1st place"
}المكافآت تأتي فقط من خادمك. هناك'لا يوجد استدعاء SDK لهم، لأن صفحة واحدة لا يمكن'ت موثوقًا بأن يقول ما الذي كسبه شخص ما.
#مرة واحدة لكل مفتاح
كل مكافأة لها المفتاح الذي تختاره، حتى 128 حروف من الأحرف والأرقام، _, ., : و -. مفتاح يدفع مرة واحدة فقط: إرسال نفس المفتاح مرة أخرى لا يدفع شيئًا ويُجيب { "status": "duplicate" } مع المبلغ الذي دفعه لأول مرة. لذلك:
- اجعل المفتاح يقول ما هي المكافأة من أجله، حتى يمكن إعادة المحاولة أو النقر المزدوج'لدفع مرتين:
daily:2026-11-01:p_3f9c…,quest-7:p_3f9c…,ad:ad_8e1c…. - هو'آمن إعادة محاولة المكافأة بعد انتهاء الوقت باستخدام نفس المفتاح.
#الحدود
| الحد | ماذا يحدث |
|---|---|
| مكافأة واحدة أكثر من 0 وأقل من 10,000 LIA، إلى 6 أرقام عشرية. | 400 bad_amount |
| يجب أن تحتفظ الخزانة بالمبلغ. | 409 pool_empty, مع ما'اليسار |
| يمكن لللاعب الحصول على أقصى ما هو الحد اليومي لكل لاعب من مجموعتك في يوم (UTC). فريق Lia يحدده؛ 0 تعني عدم وجود حد. | 429 daily_limit, مع الحد |
GET /pool اختبار'اليسار والحد اليومي. راقب الرصيد واطلب من الفريق تعبئته قبل نفاده.
#وضع الاختبار
مع مفتاح الاختبار الخاص بك، المكافآت وهمية: هم'تم تسجيله وتم إرسال ويب هوكه، ولكن خزانتك ليست'لم تستخدم، الحد اليومي غير متوفر'ت التطبيق، ولا يصل أي $LIA إلى اللاعب. المفاتيح ما زالت مسموحًا بها مرة واحدة فقط.
#الويب هوكس
كل مكافأة مدفوعة ترسل reward.paid الويب هوك مع مفتاحه، اللاعب، المبلغ، السبب، والوضع. نسخة مكرّرة لا ترسل أي شيء.
المكافأة للاعبين يجمعها مع مكافأة يومية كمثال.
تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية