Laskutus ja krediitit
API-versio 2026-10-virile-dragon
Kaksi tapaa maksaa
Asiakas laskutetaan jommallakummalla kahdesta tavasta, ja sen tila lukitaan asiakasta luotaessa. allowance-asiakas kuluttaa omistajansa tilauksen kiintiötä, samaa kiintiötä kuin sovelluksesi, eikä koskaan veloita korttia. metered-asiakas ei kuluta kiintiötä: jokainen sen kutsu maksaa krediittejä, jotka veloitetaan käytön mukaisen laskutuksen tilauksesi kortilta. Kutsu, jonka sovellus tekee toisen käyttäjän puolesta valtuutuskoodista saadulla tunnuksella, kuluttaa aina kyseisen käyttäjän kiintiötä asiakkaan tilasta riippumatta.
Krediitit kutsua kohden
metered-asiakkaan kutsu maksaa niin monta krediittiä kuin sen oikeuslaajuus on arvoltaan, ja ne luetellaan alla olevassa taulukossa; oikeuslaajuus, jonka arvo on 0 krediittiä, ei maksa mitään. Kutsun GET /v1/usage ilmoittamat units muunnetaan krediiteiksi näillä painoilla. Kutsu laskutetaan sinä päivänä voimassa olevilla painoilla, jona se tehdään, riippumatta siitä, mihin versioon asiakas on kiinnitetty: vanhemman version viiteaineiston taulukko kertoo painot sellaisina kuin ne olivat version julkaisuhetkellä, ei sitä, mitä kutsu maksaa tänään.
vocab:generate | Luo sanastolistoja. | Luo sanastolista |
lesson_plans:read | Lue tuntisuunnitelmiasi ja yhdistä uudelleen niiden edistymiseen. | Hae tuntisuunnitelmaYhdistä uudelleen tuntisuunnitelmaan |
lesson_plans:write | Luo tuntisuunnitelmia. | Luo tuntisuunnitelma |
tutor:converse | Käy tutorkeskusteluja. Vaatii maksullisen tilauksen. | Lähetä tutorvuoro |
usage:read | Katso jäljellä oleva kiintiösi tai `metered`-asiakkaan käyttö tässä kuussa. | Hae jäljellä oleva kiintiösi |
events:read | Lue tiliäsi koskevia tapahtumia ja rekisteröi päätepisteitä, jotka vastaanottavat niitä. | Listaa tapahtumatSuoratoista tapahtumat |
events:write | Lähetä tapahtumia pelistäsi tai integraatiostasi Lingaraan. | Lähetä tapahtuma |
embed:mint | Myönnä lyhytikäisiä tunnuksia pelisi tai sivustosi pelaajille ja poista pelaajia. Vain käytön mukaan laskutetuille asiakkaille. | Myönnä pelaajalle tunnusPoista pelaajaPoista pelaajan linkitys hänen Lingara-tiliinsä |
embed:play | Toimi pelaajan puolesta: lähetä hänen harjoitustuloksensa ja käy NPC-keskusteluja hänen kanssaan. | Linkitä pelaaja hänen Lingara-tiliinsäLähetä repliikki NPC:lle |
Hinta
Yksi krediitti maksaa 0,004 US$. Käyttö laskutetaan kuukausittain, kultakin kuukauden 1. päivänä (UTC) alkavalta kalenterikuukaudelta, käytön mukaisen laskutuksen tilauksesi kortilta.
Kulutusrajat
Tililläsi on kuukausittainen raja krediitteinä, ja jokaisella metered-asiakkaalla voi olla oma, matalampi rajansa; aseta molemmat Integraatiot-sivulla. Kun asiakas tai tilisi saavuttaa rajansa, asiakkaan kutsut hylätään tilakoodilla 402 ja koodilla spend_cap_reached, kunnes seuraava kuukausi alkaa tai rajaa nostetaan.
Kun käytön mukainen laskutus ei ole käytössä
metered-asiakkaan kutsut hylätään tilakoodilla 402 ja koodilla metered_billing_inactive, kun käytön mukainen laskutus ei ole käytössä: ennen kuin se on otettu käyttöön, kun maksu on erääntynyt ja sen jälkeen, kun se on peruttu. Ota käytön mukainen laskutus käyttöön, hallinnoi sitä tai peru se Integraatiot-sivulla osoitteessa app.getlingara.com/admin. Hallinnointi avaa Stripen laskutusportaalin, jossa voit vaihtaa korttisi ja lukea laskusi.
Jos käännös ja englanninkielinen viite poikkeavat toisistaan, englanninkielinen viite on oikea.