Paketi
Paketi za backend & mashirika
Kutuma mstereani
Mifumo ya backend ya Lia ya kiarabu na mifano ya kuanzisha ya kusafiri kwa TypeScript, Python, PHP na Go.
Mfumo wa kinyume ya kiarabu kwa TypeScript/JavaScript , Python, PHP na Go. Wanaongeza Lia wa kampuni moja API ya kampuni moja. Kifuniko cha kibinafsi kina matokeo ya kibinafsi; kifuniko cha kawaida inahitajia kampuni ya kawaida na kina matokeo ya kawaida.
#Tengeneza mfumo wa seva
npx @lia-labs/create-app@latest backendChagua Node.js HTTP au Express, FastAPI au Django, PHP HTTP, au Go HTTP. Mifumo ya seva inayozalishwa huthibitisha vipindi vya muda mfupi vya wachezaji na malipo yaliyokamilika, huhifadhi mali kwenye SQLite kwa risiti za kipekee, huthibitisha uwasilishaji baada ya kutoa mali kwa mafanikio, na hurejesha marekebisho ya malipo yaliyorejeshwa mara moja tu. Kiolezo cha Node pia kina changamoto za zawadi zinazotolewa na seva na mchakato wa urejeshaji wenye mipaka na kurasa.
CLI hajakamata kwa mwenyekiti kusakamana kwenye terminal au kusakamana kwenye frontend. Chagua LIA_SERVER_KEY na LIA_WEBHOOK_SECRET kwenye serikali yako. Chuja coins-100 mali kwenye Lia Mwanzilishi, kisha badilisha mapambo ya mamlaka kwenye serikali kwa mali yako ya asili. Kumbusha data/ kwenye jumla ya kuvutia. Kwa mifumo ya programu mbalimbali, badilisha SQLite ya kisasa na database ya kushiriki kwa kushiriki. Changia HTTPS na mafunzo ya kutosha ya programu kwenye mifumo ya kushiriki.
Mifano ya kushiriki kwenye framework inapatikana kwa Express, Next.js App Router, Hono, FastAPI, Django na Laravel. Mfumo wa kushirikiana hajawezi kujibua mchango wako'mwenyekiti au mafunzo ya kuzungumza; hayo huzingatia mengine wa kodi ya programu.
#Changia kwenye backend iliyopatikana
| Lugha | Paketi / asili | Ondoka |
|---|---|---|
| JavaScript / TypeScript | @lia-labs/server | npm install @lia-labs/server |
| Python | lia-labs-server | pip install 'lia-labs-server @ git+https://github.com/The-Lia-Labs/lia-server-python.git@v0.1.0' |
| PHP | lia-labs/server | Ongeza mifumo wa GitHub VCS ya kampuni kama zimeandikwa chini, kisha composer require lia-labs/server:^0.1.0 |
| Sasisha | github.com/The-Lia-Labs/lia-server-go | go get github.com/The-Lia-Labs/lia-server-go@v0.1.0 |
Python inaandikwa kutoka kwa mifumo ya GitHub; sasa hana kwenye PyPI. PHP inaandikwa kwa kutumia Composer VCS; sasa hana kwenye Packagist.
{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}Node inasomesha ESM na CommonJS na inaongeza aina ya TypeScript. Python inasaidia LiaClient na AsyncLiaClient. PHP inahitajika 8.2+ na cURL; starter ya kifanyakazi kinahitajika PDO SQLite. Go'klienti yake kina kifungu cha kawaida; kifungu cha kuanzisha kwa kujenga kwa SQLite kwa CGO na inahitajia kifungu cha C. Sio kusimamia mifumo hii katika kifungu cha browser.
#Thibitisha mshirika
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();Python: lia.require_session(session); PHP: $lia->requireSession($session); Nenda: client.RequireSession(ctx, session).
Frontend anasend kwenye sesi iliyotolewa na Lia.init() au Lia.session(), sio mshirika ID au sertifi ya server yako. Matokeo's exp ni Unix milisani. Wateja hutoa kuthibitisha jibu'kwa njia ya mtumiaji, mshangao wa mtumiaji na muda wa kusita. Ubadilishaji wa sesi ya frontend wakati inasita. API hutoa usalama wa kichaguzi na mwenyekiti wa programu.
#Mipango
Kificho cha kifuniko cha kifuniko kikamilifu kimekubaliwa makosa ya sheria. Jina kifuatacha ni jina TypeScript/PHP. Python inatumia snake_case na parameters ya kichaguzi; Go inatumia PascalCase, context.Context, lia.Params na lia.RequestOptions.
| Mkoa | Methode |
|---|---|
| Sesi | verifySession, requireSession |
| Kampuni | listProducts |
| Makosa | getCharge, deliverCharge, refundCharge, listPendingCharges |
| Makosa ya LIA | payReward, getPool |
| Maelezo | sendNotification |
| Masharti ya kushughulika | verifyAd, createAdChallenge, claimAdChallenge |
| Lobi ya mchana mengine | listTables, saveTable, sitAtTable, removeTable |
| Maombi ya kushiriki | listLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore |
| Kifundo kipimo kwa server | getPlayerStorage, setPlayerStorage |
| Webhooks | listWebhookEvents, replayWebhookEvent, kuzungumza kwa kificho na kuanzisha hadithi |
| Makamu | getAnalytics, exportAnalytics |
Kusakamana kwenye kuhifadhi kina faida expectedVersion; tatizo la mchakato ni HTTP 409. JSON null ni thamani iliyosimpani inayo amani. Uchaguzi wa browser kwa mizani hii ni kusoma tu na inapatikana kwa muda wa mizani'mtumiaji. Pesa lazima zitoke kwa kuzingatia kuzalisha kwa server; kushuka kwa pesa ambapo hajajulikana kwa kuzalisha kwa server hajapewa kuzalisha.
#Makosa na kuzalisha tena
- Kutoka kwa kifuniko cha kifuniko. Tazama
playerId,mode,productIdnapaid/deliveredhali. - Katika mchakato wa kusakinisha data moja, ongeza kificho cha kutosha kipengele cha chaguo + chaguo ID na kutoa mtaa mpya tu kama kifuniko kimekamilika.
- Kumbuka mafundisho, kisha uandike
deliverCharge. Tafuta tena uhusiano wakati wakati kipimo kimekamilika. - Kusomeka matokeo ya mali ya kuzaliwa kwa kila page ya cursor. Matokeo ya kuzaliwa kinaandikwa kwa Lia na kuzalisha tena kwenye database yako.
Wanachama wote hufanya matokeo ya 15 sekunde na kusahau kusahau kama zaidi ya mbili kwa kawaida. Hufanyika kusahau matokeo ya HTTP/mabadiliko ya mawasilio, hufuata Retry-After, kuzalisha kushirikiana na redirects na kuhakikisha kificho cha kosa kwenye kosa. Mutations hufuata Idempotency-Key iliyojitokeza na kificho cha kifichi kwa muda wa kufanyika. Kutumia kifunacho cha kampuni kwa kuzalisha tena kwa mifumo ya kuzalisha tena au mifumo ya kuzalisha tena.
await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});Python inatumia idempotency_key=...; PHP inatumia kama mfano wa pili; Nenda inatumia lia.RequestOptions{IdempotencyKey: ...}. Uthibitishaji wa mizani ni POST wa kusoma na haipaswi kujenga rekodi ya kusaidia kwa kawaida. LiaError hujumuisha msimbo, hali ya HTTP, kitambulisho cha ombi na muda wa kusubiri kabla ya kujaribu tena. Usichukulie 503 kuwa mchezaji si halali au kuwa ununuzi umekamilika. Miito salama ya GET na uthibitishaji wa vipindi ina idadi ndogo ya majaribio ya kurudia; kutekeleza shughuli za kifedha mara moja tu pia hutegemea API'na data base yako'mali ya kampuni ya kila mtu.
#Webhooks zilizosaini
Thibitisha bytes ya kawaida ambazo hajakamuliwa kabla ya kuchapisha JSON na constructWebhookEvent (Node), construct_webhook_event (Python), Webhooks::constructEvent (PHP), au ConstructWebhookEvent (Tumia) Lia-Signature mstari na mchakato wako'siri ya webhook. Uthibitishaji unatirika kwa kifanyi kipya na wakati ambapo kifanyi kipya kimepita kwa zaidi ya dakika tano kwa kawaida au kwa kawaida. Mazingira ya kifanyi kipya ambacho hazijulikana zinaweza kusikiliza bila kutoa yoyote; test:true matokeo ya kuchukua hawajipatikani kampuni.
Lia anashughulikia kifanyabiwa kikamili na kifanyabiwa kikamili ID. Anachukua kuzalisha kwa kawaida, baada ya 1 dakika, 5 dakika, 30 dakika, 2 saa, 8 saa, 24 saa na 48 saa. Kila mchakato anashughulikia tarehe ya kuzalisha mpya. Tazama maelezo kwa listWebhookEvents, na uendeleze mabadiliko ya hadithi baada ya kufix kauli yako. Kuzalisha kwa kifuniko cha kibali cha kibali hata baada ya kuzalisha. Sio kuzalisha 2xx kabla ya kufufu kwa kifuniko.
#Masharti ya mshahara
Kuzalisha mafundisho kwenye server yako na konteksti kikokoteli na mshirika ID. Rudi challengeId kwa frontend na kushiriki kama rewardContextId wakati kuchapisha adi ya kujipata. Kumbukumbu/kuwakilisha kumbukumbu kwa mshiriki, hati ya programu, aina ya adi, umri, kamilifu na kutumia tena. Kumbukumbu hakuna kushirikisha kundi la mizani peke yake; rafiki mchakato wako'kupata mali kwa kila ad yako kwenye kazi yako.
Madhara ya thamani ya kusafiri inahitajika providerVerified:true. Ukumbusho wa kificho kipya pia inahitajika kuhitimu kwa mteja wa Lia ya kawaida ili kushiriki kificho cha SSV cha kila adi na kificho cha AdMob SSV kikamilifu. Kusaidia kaskazini tu sio kutoa kumbukumbu kwa mifumo yamechaguliwa. Kumbukumbu ya kificho kipya kwenye mifumo ya kibinafsi inaonyesha matokezo, sio matokezo ya kibinafsi.
Matangazo halisi katika SDK Demo yana kikomo cha maombi 3 kwa siku ya UTC, yenye pengo la angalau dakika 30. Ununuzi na zawadi za LIA hubaki kuwa za majaribio. Sasisha Lia kutumia kipengele hiki.
#Makamu
Matokeo ya kusomeka yanashughulikia mwanasiasa wakati wa kila siku, mali na kutosha kwa kutosha, matokeo ya ad na kutosha kwa kila toleo la ad na D1/D7/D30. CSV ina matokeo ya kusomeka, ad na aina ya kutosha. Kusomeka kwa kutosha kuanza kwa kura hii; kundi la kawaida kwa kawaida hajafanywa. Kusomeka kwa kutosha kwa ad hajafanywa kwa kamilifu inatuma maegesho ya kuchangia. Matokeo ya kusomeka kwa SDK ni kikamilifu, sio kiasi kwa kamilifu AdMob au kumbukumbu ya kusomeka kwa mshirika.
Dhibiti misimu, ficha au rudisha alama, kagua majaribio ya uwasilishaji wa webhook na tuma matukio tena kupitia Lia Developers. Uchanganuzi unajumuisha programu za timu yako na usafirishaji wa CSV. Data ya majaribio na ya uzalishaji hutenganishwa.
#Kuthibitisha
Kwa kampuni lia-sdk kodi:
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-appChangia Postman CLI, PHP na cURL na Go kwanza. Hii inafanyika kila miwili ya kijana kwa kifanyabiwa kwa Postman HTTP la kwanza kwa lokal, kwa kawaida kwa kusahau, kuzalisha mabadiliko, kusahau ya muda, kuzunguka, muda wa kuzalisha na kuzalisha kwa kifanyabiwa. Haichanganyiki data ya kibao. Tazama scripts/developer-server-features-local-test.mjs katika mifumo wa API kwa kipimo kipya kwa kipimo kikuu cha kampeni cha kisasa.
Kutafsiri kwa kawaida. Kiingereza kina maana ya kawaida. Kusoma kwa Kiingereza