Liaविकासकर्ता

पैकेज

आधिकारिक Lia बैकएंड क्लाइंट और TypeScript, पायथन, PHP और गो के लिए सुरक्षित स्टार्टर परियोजनाएं।

के लिए आधिकारिक सर्वर क्लाइंट TypeScript/JavaScript, पायथन, PHP और गो. वे समान एप-स्कोप्ड Lia सर्वर API कॉल करते हैं। एक परीक्षण कुंजी के लिए परीक्षण रिकॉर्ड देखे जाते हैं; एक लाइव कुंजी के लिए एक लाइव एप होना आवश्यक है और लाइव रिकॉर्ड देखे जाते हैं।

#बैकएंड जनरेट करें

npx @lia-labs/create-app@latest backend

Node.js HTTP या Express, FastAPI या Django, PHP HTTP या Go HTTP चुनें। बनाए गए बैकएंड कम अवधि वाले प्लेयर सेशन और भुगतान किए गए चार्ज की पुष्टि करते हैं, अद्वितीय रसीदों के साथ SQLite इन्वेंट्री रखते हैं, सफल अनुदान के बाद डिलीवरी की पुष्टि करते हैं और रिफंड को केवल एक बार वापस समायोजित करते हैं। Node स्टार्टर में सर्वर द्वारा जारी रिवार्ड चैलेंज और सीमित, पृष्ठों में विभाजित रिकवरी प्रक्रिया भी शामिल है।

कभी-कभी CLI आपसे टर्मिनल आर्ग्यूमेंट में एक रहस्य चिपकाने के लिए नहीं कहता है या फ्रंटएंड में एक लिखता है। सेट LIA_SERVER_KEY और LIA_WEBHOOK_SECRET अपने सर्वर पर। बनाएं coins-100 उत्पाद को Lia डेवलपर्स में, फिर अपने वास्तविक उत्पादों के लिए सर्वर-स्वामित्व अधिकार नक्शा बदलें। स्थायी data/ एक टिकाऊ आयतन पर। बहुगुणित एप्लिकेशन इकाइयों के लिए, नमूना SQLite स्टोर के स्थान पर एक साझा लेनदेन डेटाबेस का उपयोग करें। उत्पादन होस्टिंग पर HTTPS और एप्लिकेशन-विशिष्ट दर सीमाएं सेट करें।

फ्रेमवर्क एकीकरण उदाहरण शामिल हैं लिए एक्सप्रेस, Next.js एप राउटर, हॉनो, FastAPI, डिज़ाइन और लारावेल. एक फ्रेमवर्क एडाप्टर आपके खेल का निर्धारण नहीं कर सकता'के अधिकार या एंटी-चीट नियम; वे सर्वर-स्वामित्व एप्लिकेशन कोड रहेंगे।

#एक विद्यमान बैकएंड में स्थापित करें

भाषापैकेज / स्रोतस्थापित करें
JavaScript / TypeScript@lia-labs/servernpm install @lia-labs/server
पायथनlia-labs-serverpip install 'lia-labs-server @ git+https://github.com/The-Lia-Labs/lia-server-python.git@v0.1.0'
PHPlia-labs/serverनीचे दिए गए कंपनी GitHub VCS रिपॉजिटरी को जोड़ें, फिर composer require lia-labs/server:^0.1.0
गोgithub.com/The-Lia-Labs/lia-server-gogo get github.com/The-Lia-Labs/lia-server-go@v0.1.0

पायथन अपने टैग किए गए GitHub स्रोत से स्थापित किया जा सकता है; इसे अभी तक PyPI पर सूचीबद्ध नहीं किया गया है। PHP को कॉम्पोजर VCS के माध्यम से स्थापित किया जा सकता है; इसे अभी तक पैकेजिस्ट पर सूचीबद्ध नहीं किया गया है।

{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}

नोड ESM और CommonJS का समर्थन करता है और TypeScript प्रकार शामिल है। पायथन प्रदान करता है LiaClient और AsyncLiaClient. PHP के लिए 8.2+ और cURL की आवश्यकता होती है; जनरेटेड इंवेंटरी स्टार्टर के लिए PDO SQLite की आवश्यकता होती है। गो'क्लाइंट मानक पुस्तकालय का उपयोग करता है; इसके जनित इन्वेंटरी स्टार्टर में SQLite से CGO तक का उपयोग होता है और एक C कंपाइलर की आवश्यकता होती है। ब्राउजर बंडल में इन पैकेजों को आयात न करें।

#खिलाड़ी की पहचान करें

import {LiaClient} from '@lia-labs/server';
const lia = new LiaClient(process.env.LIA_SERVER_KEY!);
const player = await lia.requireSession(sessionFromLia);
const {products} = await lia.listProducts();

पायथन: lia.require_session(session); PHP: $lia->requireSession($session); जाओ: client.RequireSession(ctx, session).

फ्रंटएंड सत्र भेजता है जो द्वारा वापस कर दिया गया है Lia.init() या Lia.session(), आपके खिलाड़ी ID या आपके सर्वर कुंजी नहीं है। परिणाम's exp है यूनिक्स मिलीसेकंड. क्लाइंट उत्तर की जांच करते हैं'के मोड, खिलाड़ी के आकार और समाप्ति। जब यह समाप्त हो जाता है तो फ्रंटएंड सत्र को रीन्यू करें। API स्वयं हस्ताक्षर और एप्लिकेशन स्वामित्व की पुष्टि करता है।

#ऑपरेशन

साझा मशीन-पठनीय समझौता है ऑपरेशन समावेशी अनुबंध. नीचे दिए गए नाम TypeScript/PHP नाम हैं। पायथन में स्नेक_केस और कीवर्ड पैरामीटर का उपयोग किया जाता है; गो में PascalCase का उपयोग किया जाता है, context.Context, lia.Params और lia.RequestOptions.

क्षेत्रविधियां
सत्रverifySession, requireSession
कैटलॉगlistProducts
खरीदारीgetCharge, deliverCharge, refundCharge, listPendingCharges
LIA पुरस्कारpayReward, getPool
अपडेटsendNotification
पुरस्कार विज्ञापनverifyAd, createAdChallenge, claimAdChallenge
बहुखेला लॉबीlistTables, saveTable, sitAtTable, removeTable
प्राधिकरण स्कोरlistLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore
केवल सर्वर स्टोरेजgetPlayerStorage, setPlayerStorage
वेबहुकlistWebhookEvents, replayWebhookEvent, कच्चा हस्ताक्षर सत्यापन और घटना निर्माण
विश्लेषणgetAnalytics, exportAnalytics

स्टोरेज लिखावट की आवश्यकता होती है expectedVersion; एक विवाद HTTP 409. JSON null एक वैध संग्रहित मान है। इस स्टोरेज तक ब्राउज़र एक्सेस केवल पठनीय है और सत्र से बंधा हुआ है'खिलाड़ी। स्कोर सर्वर-सत्यापित खेल से आना चाहिए; अनविश्वसनीय स्कोर को सर्वर एंडपॉइंट पर ले जाना इसे प्राधिकरण नहीं बनाता।

#खरीदारी और पुनः प्रयास

  1. सर्वर कुंजी के साथ शुल्क लें। जांचें playerId, mode, productId और एक paid/delivered स्थिति।
  2. एक डेटाबेस लेनदेन में, अद्वितीय रसीद को द्वारा डालें मोड + चार्ज ID और केवल यदि विक्रय प्रमाण नया है तो मैप किए गए अधिकार की अनुमति दें।
  3. इन्वेंटरी को सुरक्षित करें, फिर कॉल करें deliverCharge. अनुमोदन करें, भले ही स्टॉक लगभग दिया गया हो।
  4. सभी कर्सर पेज का उपयोग करके अपेक्षित भुगतान प्राप्ति को समायोजित करें। रिफंड को Lia के खिलाफ फिर से जांचना आवश्यक है और अपने डेटाबेस में एक बार वापस कर देना चाहिए।

सभी क्लाइंट्स के पास डिफ़ॉल्ट रूप से एक 15-सेकंड के अनुरोध बजट होते हैं और अधिकतम दो बार पुनः प्रयास करते हैं। वे अस्थायी HTTP/नेटवर्क विफलताओं के लिए पुनः प्रयास करते हैं, और अपनाते हैं Retry-After, प्रमाणित पुनर्निर्देशन को अस्वीकार करें और त्रुटियों से कच्चे त्रुटि शरीर को छोड़ दें। म्यूटेशन एक कॉल के भीतर समान जनरेटेड इडेम्पोटेंसी-की और सीरियलाइज्ड बॉडी बनाए रखते हैं। प्रक्रिया रीस्टार्ट या अलग कॉल के माध्यम से दोहराने पर एक स्थिर व्यावसायिक कुंजी पास करें।

await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});

पायथन का उपयोग idempotency_key=...; PHP द्वितीय तर्क के रूप में ले लेता है; जाओ उपयोग करता है lia.RequestOptions{IdempotencyKey: ...}. सत्र सत्यापन एक पठन-शैली POST है और अनावश्यक आइडेम्पोटेंसी रिकॉर्ड नहीं बनाता है। LiaError एक कोड, HTTP स्थिति, अनुरोध ID और पुनः प्रयास देरी शामिल है। कभी-कभी 503 को अमान्य खिलाड़ी या पूर्ण खरीद के रूप में न लें। सुरक्षित GETs और सत्र सत्यापन में सीमित पुनः प्रयास होते हैं; वित्तीय ठीक एक बार के व्यवहार पर API पर निर्भर करता है'आपके डेटाबेस के साथ'के विशिष्ट व्यावसायिक रसीद।

#हस्ताक्षरित वेबहुक

सत्यापित करें पार्सिंग से पहले JSON के अस्पर्शित कच्चे बाइट्स साथ में constructWebhookEvent (नोड), construct_webhook_event (पायथन), Webhooks::constructEvent (PHP), या ConstructWebhookEvent (जाएं)। उपयोग करें Lia-Signature हेडर और आपकी एप्लिकेशन'के वेबहुक गुप्त। सत्यापन असली डेटा और तीन मिनट से अधिक पुराने या भविष्य के समय-चिह्नों को अस्वीकार कर देता है। अज्ञात हस्ताक्षरित घटना प्रकार को कुछ भी प्रदान किए बिना स्वीकृत किया जा सकता है; test:true परीक्षण कभी-कभी स्टॉक प्रदान नहीं करते।

Lia एक स्थिर घटना ID के साथ एक टिकाऊ बाहरी डिब्बा रखता है। यह तुरंत डिलीवरी की कोशिश करता है, फिर 1 मिनट, 5 मिनट, 30 मिनट, 2 घंटे, 8 घंटे, 24 घंटे और 48 घंटे के बाद। प्रत्येक प्रयास के लिए एक नया हस्ताक्षर समय-चिह्न होता है। उपयोग करके मेटाडेटा की जांच करें listWebhookEvents और अपने हैंडलर के बाद घटना को दोहराएं। दोहराने के बाद भी स्थिर व्यावसायिक प्राप्तियों द्वारा डुप्लिकेट को दूर करें। पूर्णता के बाद 2xx वापस न करें।

#पुरस्कार चुनौतियाँ

अपने सर्वर पर एक सर्वर-स्वामित्व वाले संदर्भ और खिलाड़ी ID के साथ एक चुनौती बनाएं। वापस करें challengeId फ्रंटएंड में जाएं और इसे बनाए रखें rewardContextId खिलाड़ी, एप मोड, विज्ञापन फॉर्मेट, उम्र, पूर्णता और पुन: उपयोग की जांच करता है। एक दावा अकेले इन्वेंटरी प्रदान नहीं करता है; अपने खेल को अनुमति दें'आपके अपने लेन-देन में प्रत्येक विज्ञापन के लिए एक बार अपने अधिकार का उपयोग करें।

जीवंत मूल्यवान पुरस्कार आवश्यकता है providerVerified:true. नई प्रमाण प्रवाह में प्रति विज्ञापन SSV नॉन्स और AdMob SSV कॉलबैक कॉन्फ़िगर करने के लिए अपडेटेड नैटिव Lia होस्ट की आवश्यकता होती है। बैकएंड समर्थन अकेला पहले से स्थापित एप्लिकेशन को अपग्रेड नहीं करता है। टेस्ट मोड नैटिव पूर्णता सिमुलेटेड सबूत है, कभी-कभी वास्तविक प्रदाता-हस्ताक्षरित प्रमाण नहीं।

SDK Demo में वास्तविक विज्ञापन प्रति UTC दिन 3 अनुरोधों तक सीमित हैं, जिनके बीच कम से कम 30 मिनट होंगे। खरीदारी और LIA पुरस्कार सिम्युलेटेड रहेंगे। इस सुविधा के लिए Lia अपडेट करें।

#विश्लेषण

रिपोर्ट में दैनिक सक्रिय खिलाड़ी, खरीदारी और भुगतान करने वाले खिलाड़ी के रूप में रिकॉर्डिंग, प्रति-फॉर्मेट विज्ञापन टेलीमेट्री और D1/D7/D30 रिटेंशन शामिल हैं। CSV में गतिविधि, विज्ञापन और रिटेंशन रिकॉर्ड प्रकार शामिल हैं। रिटेंशन संग्रह इस रिलीज के साथ शुरू होता है; ऐतिहासिक कोहॉर्ट नहीं बनाए जाते हैं। अपूर्ण विज्ञापन अवधारणा कवरेज शून्य मीट्रिक्स लौटाता है। SDK द्वारा रिपोर्ट किए गए राजस्व अंतिम AdMob कमाई या विकासकर्ता भुगतान विवरण नहीं हैं, बल्कि अनुमान हैं।

Lia Developers से सीज़न प्रबंधित करें, स्कोर छिपाएँ या बहाल करें, वेबहुक डिलीवरी के प्रयास देखें और इवेंट दोबारा भेजें। एनालिटिक्स में आपकी टीम के ऐप और CSV निर्यात शामिल हैं। टेस्ट और लाइव डेटा अलग रहते हैं।

#सत्यापन

कंपनी से lia-sdk रिपॉजिटरी:

npm install
python3 -m venv .venv
.venv/bin/pip install -e backends/python
LIA_PYTHON=.venv/bin/python npm run test:backends
npm run test:create-app

Postman CLI स्थापित करें, PHP के साथ cURL और फिर Go पहले। यह स्थानीय पहले-पक्ष Postman HTTP सिमुलेशन के माध्यम से सभी चार वास्तविक क्लाइंट्स को चलाता है, जिसमें अस्थायी विफलताएं, दोहराए गए परिवर्तन, सत्र समाप्त होना, पुनर्निर्देशन, समय सीमा और वेबहुक धोखाधड़ी शामिल हैं। यह उत्पादन डेटा को छूता नहीं है। देखें scripts/developer-server-features-local-test.mjs अलग-अलग एकीकरण परीक्षण के लिए वास्तविक स्थानीय वर्कर के खिलाफ API भंडार में।

स्वचालित अनुवाद। अंग्रेजी सत्य का स्रोत है। अंग्रेजी में पढ़ें

किसी भी पृष्ठ, विधि और एंडपॉइंट के लिए खोजने के लिए प्रकार।