Makosa ya serikali

Kundi la API unapewa kwenye mgonjwa wako mwenyewe kwa kifuniko chao cha siri. Thibitisha mizani, onyesha mizani, kuthibitisha, kuzalisha na kuzalisha kifuniko, kuzalisha mali kutoka kwa kifuniko chako, kuzalisha mabadiliko, kuchekesha mizani na onyesha mizani ya kawaida.

#Masharti ya kwanza

Kumbuka kwa mteja wako tu. Kitambu chako ni sirri: usisame kwenye mstereani wako.

curl https://api.lialabs.org/api/apps/v1/pool \
  -H "Authorization: Bearer $LIA_KEY"

Mwana wa kifupi unavyotumia katika mfano uliopita:

const LIA = "https://api.lialabs.org/api/apps/v1";

export async function lia(method, path, body) {
  const res = await fetch(LIA + path, {
    method,
    headers: { Authorization: `Bearer ${process.env.LIA_KEY}`, "Content-Type": "application/json" },
    body: body === undefined ? undefined : JSON.stringify(body),
  });
  const data = await res.json();
  if (!res.ok) throw Object.assign(new Error(data.error), { status: res.status, data });
  return data;
}

#Siri na mifumo

Kifuniko kimoja kinaona tu kwa app yake mmoja, na kwa kipimo chake mmoja: kifuniko cha kuzalisha kinaona kuzalisha mizani, kifedha, mshirikiano na adi; kifuniko cha kusimama kinaona kusimama. Kipimo kimekosa kwa kipimo chini kimekosa not_found (au valid: false). Tazama Ukumbusho na kusimamia.

#Kosa

Kosa hujibu na kipimo 4xx na kifupi kinachotaja error mifano ya kodio, kwa kawaida na mitindo zaidi:

{ "error": "pool_empty", "pool": 3.5 }

Kila endpoint ina yake. Kila kodu ni katika Kosa kodi.

#Sesi

#POST/session/verify

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/session/verify' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-request-1' \
  --data-raw '{
  "session": "lias_example_session"
}'

Kutafuta token ya mzunguko kwa Lia.init() au Lia.session(), na kusisimua wao ni mwenye

POST /api/apps/v1/session/verify
Authorization: Bearer lia_live_…
Content-Type: application/json

{ "session": "lias_eyJhcHAiOi…" }

Jibu 200 kwa kila njia:

{ "valid": true, "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "mode": "live", "exp": 1761998400000 }

{ "valid": false }

Kificho kina uwezo wakati Lia alikwenda, ina's kwa mfumo wako na siri yako'katika hali yake, na bado haija't ended (15 minutes after it was made).

#Vidokezo

#GET/products

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request GET 'https://api.lialabs.org/api/apps/v1/products' \
  --header "Authorization: Bearer $LIA_KEY"

Nini app yako inayosell, kwa bei kwenye Lia'mwenyewe rekodi. Tu mali ya kushiriki, kwanza kwa kiasi cha chini.

{
  "products": [
    { "id": "extra-lives", "name": "3 extra lives", "price": 5, "active": true },
    { "id": "gold-pack", "name": "Gold pack", "price": 25, "active": true }
  ]
}

#Mali

Kumbukumbu ni moja ya kifedha kwenye Lia'mwenyewe kificho cha malipo. Tazama Malipo.

Kumbukumbu ya matokeo:

#GET/charges/:id

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request GET 'https://api.lialabs.org/api/apps/v1/charges/id_example' \
  --header "Authorization: Bearer $LIA_KEY"

Je hii ni mali ya kuvunjika, inayotolewa na mmoja? Kila wakati tazama hapa kabla ya kuzalisha: sikuwezi kuchukua peta's au webhook'neno kwa yote.

{
  "charge": {
    "id": "ch_9b1f4c2e7a0d5b8f3e6a1c4d",
    "playerId": "p_3f9c0a6d1b2e4f5a6b7c",
    "productId": "extra-lives",
    "amount": 5,
    "status": "paid",
    "mode": "live",
    "createdAt": 1761998400000,
    "deliveredAt": null,
    "refundedAt": null
  }
}

#POST/charges/:id/deliver

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/charges/id_example/deliver' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Idempotency-Key: example-request-1'

Kumbukumbu ya kuchukua, kisha'amefunda mtu ambaye alipiga. Safe kuzalisha: kuzalisha kumbukumbu kimefanyika haina matokeo na kujibu kama alivyo. Haina mwanafunzi.

{ "charge": { "id": "ch_9b1f…", "status": "delivered", "deliveredAt": 1761998405000, "…": "…" } }

#POST/charges/:id/refund

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/charges/id_example/refund' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Idempotency-Key: example-request-1'

Kutuma $LIA kwa mwanamazingo, wakati unaweza't deliver what they bought. Works on a paid or a delivered charge. Safe to repeat: refunding a refunded charge answers with it and pays nothing more. No body.

{ "charge": { "id": "ch_9b1f…", "status": "refunded", "refundedAt": 1761998410000, "…": "…" } }

Jumla ya bei inapaswa kuzikwenda kwa mwanaharakati.'kutoka kwenye mstari, kwa mstari wa kutosha, kusindikiza Lia'mwenyewe sehemu na kiasi lako. A charge.refunded webhook inatoka.

#Kukusanyika

Tazama Kukusanyika kwa jumla.

#POST/rewards

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/rewards' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-request-1' \
  --data-raw '{
  "playerId": "player_example",
  "amount": 1,
  "key": "reward-example-1",
  "reason": "Level completed"
}'

Anayatuma mshahara kwa kifundo chako'kikosi cha mshahara, kila mmoja kwa siku.

POST /api/apps/v1/rewards
Authorization: Bearer lia_live_…
Content-Type: application/json

{
  "playerId": "p_3f9c0a6d1b2e4f5a6b7c",
  "amount": 25,
  "key": "tournament-2026-11-01:p_3f9c0a6d1b2e4f5a6b7c",
  "reason": "Weekly tournament, 1st place"
}

Imepaidwa:

{ "status": "paid", "amount": 25, "pool": 975 }

Kama kama kifuniko kikichukua kiasi, hajafunika na kujibu kama kifuniko kwanza kikichukua:

{ "status": "duplicate", "amount": 25, "pool": 975 }

pool huanushirikishwa tena. Kwa's kushoto kwenye kifuniko chako baada yote. Katika mazingira ya kusimamia, kifuniko kimepiga: kifuniko kimepiga.'kukabili kwenye kifuniko kwa kifuniko cha siku na kifuniko cha siku cha kila mmoja hajafunzi't kuchukua.

A reward.paid webhook inatoka kwa kila mshirika uliopokelewa (sio kwa kila mshirika mmoja).

#GET/pool

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request GET 'https://api.lialabs.org/api/apps/v1/pool' \
  --header "Authorization: Bearer $LIA_KEY"

Nini's kushoto kwenye kifuniko chako, na kikubwa ambacho mmoja mmoja anaweza kuzaliwa kwa siku.

{ "balance": 975, "dailyCapPerPlayer": 50, "mode": "live" }

dailyCapPerPlayer ni 0 wakati wapi'jina lako mwingine haina kikomo cha siku moja. balance huanushirikishwa tena. Kwa

#Maelezo

Tazama Maelezo.

#POST/notifications

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/notifications' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-request-1' \
  --data-raw '{
  "playerId": "player_example",
  "text": "Ready for another round?",
  "startParam": "round_2"
}'

Tuma matokeo kwa mteja ambaye alipokea. Inaonyeshwa kwenye mifumo yako'jina lako na yafungua programu yako kwa jina lako startParam.

POST /api/apps/v1/notifications
Authorization: Bearer lia_live_…
Content-Type: application/json

{ "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "text": "It's your move against @amara.", "startParam": "match-8k2d" }

Tumia:

{ "sent": true, "pushed": true }

pushed ni false wakati ituweza kufikia Lia'kutoka kwenye mstari kama simu (mwanachama anapewa Lia'mwenyewe kushiriki (kabla ya kushiriki).

#Ad

Tazama Ad.

#POST/ads/verify

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/ads/verify' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-request-1' \
  --data-raw '{
  "adId": "ad_example"
}'

Ililipwa ad hili kwa kina na kwa nani? Tazama kabla ya kutoa yoyote kwa video inayotafuta.

POST /api/apps/v1/ads/verify
Authorization: Bearer lia_live_…
Content-Type: application/json

{ "adId": "ad_8e1c4b0f2a9d47c6b3e15a07" }

{ "adId": "ad_8e1c4b0f2a9d47c6b3e15a07", "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "format": "rewarded", "watched": true, "watchedAt": 1761998400000 }

Tuma na siri ya mchango ambapo ad inayotumiwa: ad ya kusimamia (kwa kawaida moja ya Google'kawaida ya kuzigundua, sio kuchukua kwa kiasi cha kawaida) ni not_found kwa kifuniko cha kuvutia.

Lia sio't kuanzisha mafanikio kama unapakia, kwa kila mafanikio adId kwa muda mmoja mwenyewe (tumia ad:<adId> kama mshahidi wa mshahidi).

#Lobby

Maktaba ya kawaida ambayo yote wana wakati Lia wanaweza kupata. Lia inafanya tu kuchapisha: server yako inafanya maktaba. Tazama Maktaba ya kawaida.

Kifano cha mifano:

#POST/lobby/tables

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/lobby/tables' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-request-1' \
  --data-raw '{
  "tableId": "table_example",
  "hostPlayerId": "player_example",
  "seats": 2,
  "taken": 1,
  "title": "A friendly game",
  "stake": 1,
  "pot": 1,
  "expiresIn": 1800
}'

Kumbukumbu mifumo ambao'imefungua kwa mshirika, au inatumia upya kificho (inachukua nafasi yake katika orodha). Tuma kificho tena wakati matokeo yao yanachangia.

{ "tableId": "t8k2d", "hostPlayerId": "p_3f9c0a6d1b2e4f5a6b7c", "seats": 2, "taken": 1, "title": "Quick game", "stake": 5, "expiresIn": 900 }

{ "listed": true, "tableId": "t8k2d", "seats": 2, "taken": 1, "expiresAt": 1761999300000 }

Wakati taken inapita seats, kama tabia inaondolewa kwenye orodha, na jibu ni { "listed": false }.

#GET/lobby/tables

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request GET 'https://api.lialabs.org/api/apps/v1/lobby/tables' \
  --header "Authorization: Bearer $LIA_KEY"

Mizani yako's kuvunjika kwenye kichaguo chako'katika hali yake, mpya zaidi kwanza, hadi 200: kila mwenyeji'na block zilizochukuliwa (ambalo's kwa kila mshirika'yeye mazinga).

{ "tables": [{ "id": "t8k2d", "game": "your-app", "host": { "name": "amara" }, "seats": 2, "taken": 1, "title": "Quick game", "stake": 5, "pot": 0, "createdAt": 1761998400000, "expiresAt": 1761999300000 }] }

#POST/lobby/tables/:id/sit

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request POST 'https://api.lialabs.org/api/apps/v1/lobby/tables/id_example/sit' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-request-1' \
  --data-raw '{
  "playerId": "player_example"
}'

Kusimamia mwanafunzi kwenye meza iliyotajwa, kabla ya kushughulikia mwanafunzi kwenye server yako. Lia anatuma watu ambao waliwakiliza host au waliwakiliza host. Wakati meza ya kwanza inapokekana, meza inapoteza kutoka kwenye orodha.

{ "playerId": "p_8a1e0c4d2b7f9e3a5c6d" }

{ "seated": true, "taken": 2, "seats": 2, "full": true }

#DELETE/lobby/tables/:id

# Set LIA_KEY on your server. Reuse Idempotency-Key only for the same request.
curl --request DELETE 'https://api.lialabs.org/api/apps/v1/lobby/tables/id_example' \
  --header "Authorization: Bearer $LIA_KEY" \
  --header 'Idempotency-Key: example-request-1'

Kununua majengo kwenye orodha, wakati mchezo unapakia au unapakia. Salama kusambaa.

{ "removed": true }

removed ni false wakati ituweza si't kushiriki.

#Kutafuta tena

Kusoma kwa Idempotency-Key header kila POST, na kificho kimoja kwa kila usambazaji. Usambazaji kisha sio kufanyia kazi kwa muda mmoja, na kujibu kama kificho kwanza ilikuwa.

POST /api/apps/v1/notifications
Authorization: Bearer lia_live_…
Content-Type: application/json
Idempotency-Key: 6f1c2a9e-0b7d-4c35-9e1a-2d8f4b7c3a10

{ "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "text": "It's your move." }

• Kifadhi chenye yoyote, 1 kwa 128 ya harufu, namba, _, -, . na :. UUID moja kwa kila operesheni inafaa.
• Mchakato wa kwanza unapita. Kama inafanikiwa (2xx), jibu lote linalohifadhiwa kwa 24 saa, na kurejesha kwa kifuniko hicho na matokeo ya kifuniko hicho, na kifuniko cha kifuniko Idempotent-Replayed: true.
• Kukataa hakuhifadhi chochote (kutoka 4xx au 5xx), kwa hivyo unaweza kusahau saba na kuchukua tena kwa kichaguo hicho.
• Kifuniko kama kama na kifuniko kikichukua kikichanganyika ni 422 idempotency_key_reused.
• Kifuniko kama kama wakati kifuniko kwanza hakuwa kushuka ni 409 idempotency_key_in_use na Retry-After: 1. Mchakato tena, na unapokea mchakato wa kwanza'kutoka kwenye mstari.
• Siri ni maelezo yako's yake mwenyewe, na kutosha na kutosha hujisifu kwa kila mmoja. Kificho kimoja kwenye endpoint mwingine ni kificho mwingine.

Bila kushirikiana na header, mengine ya endpoints hujui kusafisha: kusoma hajichangia kipato, kushirikiana na kurejeshwa ni kusafisha kusafisha, na mshirika unapokea kwa kila key. Mabarehe yana mabadiliko: bila kificho, mchakato unapokea mabarehe tena.

Kutafsiri kwa kawaida. Kiingereza kina maana ya kawaida. Kusoma kwa Kiingereza