Lingara Lingara Belge Rêbername API Pirtûkxane Sepan Avakirin Sepana webê
Ziman: Kurdî

Mafê xwe yê bikaranînê yê mayî bistîne

Guhertoya API 2026-10-affable-towhee

get https://api.getlingara.com/v1/usage

Her mafê bikaranînê yê ku li ser hesabê te derbas dibe rêz dike, bi çiqas hatiye bikaranîn û kengî ji nû ve dest pê dike.

Scope usage:read

Parametre

Lingara-Versionheaderstringvebijarkî
Guhertoya API ya ku ev daxwaz pê tê bersivandin. Bêyî wê, tokena gihîştinê guhertoya ku klientê wê pê ve girêdayî ye distîne, û daxwazeke bê token guhertoya niha distîne. Guhertoya ku hîn di pêşxistinê de ye tenê bi binavkirina wê li vir tê gihîştin. Guhertoyeke nenas bi 400 û koda api_version_unknown tê bersivandin. GET /v1/versions guhertoyan rêz dike.

Bersiv

200 Mafê te yê bikaranînê

allowancearray of AllowanceRowpêwîst
featurestringpêwîst
windowstringpêwîst
limitintegerpêwîst
usedintegerpêwîst
remainingintegerpêwîst
reset_atinteger | nullvebijarkî
ledgerUsageLedger | nullvebijarkî

Bang û yekeyên vê klientê ji nîvê şevê ya UTC ya roja yekem a mehê ve. Tenê ji bo klienteke pîvandî heye, ku bangên wê tu mafê bikaranînê xerc nakin. Dibe ku heta pênc çirkeyan li dû banga te ya dawî be.

sincestringpêwîst
callsintegerpêwîst
unitsintegerpêwîst

Çewtî

410application/json
Guhertoya API ya ku ev daxwaz pê tê bersivandin hate rawestandin. Guhertoyeke piştgirîkirî di Lingara-Version de bişîne, an klientê bi guhertoyeke din ve girê bide.
4XXapplication/json
Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.
503application/json · text/plain
Xizmet bi demkî ne berdest e; piştî hejmara çirkeyên di Retry-After de dîsa biceribîne. Di dema lênêrînê de naverok nivîsa sade ye, ne zerfa çewtiyê.
5XXapplication/json
Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.
codestringpêwîst

Çima daxwaz hat redkirin, wek kodeke domdar ku mirov li gorî wê şax dike: bo nimûne insufficient_scope (403), rate_limited (429) û, ji bo klienteke pîvandî, spend_cap_reached (402) û metered_billing_inactive (402).

errorstringpêwîst

Mînak

Zimanê mînaka kodê

curl

curl "https://api.getlingara.com/v1/usage" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

TypeScript

const usage = await client.getUsage();
for (const row of usage.allowance) {
  console.log(row.feature, row.window, `${row.remaining} of ${row.limit} left`);
}

Rust

let usage = client.get_usage().await?;
for row in &usage.allowance {
    println!("{} {}: {} of {} left", row.feature, row.window, row.remaining, row.limit);
}

Go

usage, err := client.GetUsage(ctx)
if err != nil {
	return err
}
for _, row := range usage.Value.Allowance {
	fmt.Printf("%s (%s): %d of %d left\n", row.Feature, row.Window, row.Remaining, row.Limit)
}

Java

import com.getlingara.client.model.AllowanceRow;
import com.getlingara.client.model.Usage;

Usage usage = client.getUsage().body();
for (AllowanceRow row : usage.getAllowance()) {
  System.out.println(
      row.getFeature()
          + " ("
          + row.getWindow()
          + "): "
          + row.getRemaining()
          + " of "
          + row.getLimit()
          + " left");
}

Kotlin

val usage = client.getUsage().body
for (row in usage.allowance) {
    println("${row.feature} (${row.window}): ${row.remaining} of ${row.limit} left")
}

Ruby

usage = client.get_usage.value
usage.allowance.each { |row| puts "#{row.feature} (#{row.window}): #{row.remaining} of #{row.limit} left" }
puts "#{usage.ledger.calls} calls this month" if usage.ledger

PHP

foreach ($client->getUsage()->value->getAllowance() as $row) {
    echo $row->getFeature(), ': ', $row->getRemaining(), ' of ', $row->getLimit(), ' left this ', $row->getWindow(), "\n";
}

Pirtûkxaneyek tercîh dikî? Beşa Pirtûkxaneyan bibîne.

Ger wergerek û referansa Îngilîzî ji hev cuda bin, referansa Îngilîzî rast e.