Lingara Lingara لارښود لارښودونه API کتابتونونه اپلیکیشنونه جوړول ویب اپلیکیشن
ژبه: پښتو

خپله پاتې ونډه ترلاسه کړئ

د API نسخه 2026-10-affable-towhee

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

هره هغه ونډه لیست کوي چې ستاسو په حساب پلي کېږي، له دې سره چې څومره کارول شوې او کله بیا تنظیمېږي.

ساحې usage:read

پیرامیټرونه

Lingara-Versionheaderstringاختیاري
د API هغه نسخه چې دې غوښتنې ته پرې ځواب ورکول کېږي. له دې پرته، لاسرسي ټوکن هغه نسخه ترلاسه کوي چې د هغه کلاینټ ورسره تړل شوی، او بې ټوکنه غوښتنه اوسنۍ نسخه ترلاسه کوي. هغې نسخې ته چې لا هم د پراختیا په حال کې ده یوازې دلته د هغې په نومولو رسېدای شئ. نامعلومې نسخې ته د 400 او کوډ api_version_unknown سره ځواب ورکول کېږي. GET /v1/versions نسخې لېست کوي.

ځوابونه

200 ستاسو ونډه

allowancearray of AllowanceRowاړین
featurestringاړین
windowstringاړین
limitintegerاړین
usedintegerاړین
remainingintegerاړین
reset_atinteger | nullاختیاري
ledgerUsageLedger | nullاختیاري

د میاشتې د لومړۍ نېټې د UTC نیمې شپې راهیسې د دې کلاینټ غوښتنې او واحدونه. یوازې د کارونې له مخې بیل شوي کلاینټ لپاره شته، چې غوښتنې یې هېڅ ونډه نه لګوي. کېدای شي ستاسو له وروستۍ غوښتنې تر پنځو ثانیو پورې وروسته وي.

sincestringاړین
callsintegerاړین
unitsintegerاړین

تېروتنې

410application/json
د API هغه نسخه چې دې غوښتنې ته پرې ځواب ورکول کېږي بنده شوې ده. په Lingara-Version کې یوه ملاتړ شوې نسخه ولېږئ، یا کلاینټ له بلې نسخې سره وتړئ.
4XXapplication/json
غوښتنه رد شوه. code لامل ښیي، او error یې په کلمو بیانوي.
503application/json · text/plain
خدمت په لنډمهاله توګه نه شته؛ د هغو ثانیو له تېرېدو وروسته بیا هڅه وکړئ چې په Retry-After کې راغلي دي. د ساتنې پر مهال، د ځواب بدنه د تېروتنې د پاکټ پر ځای ساده متن وي.
5XXapplication/json
غوښتنه رد شوه. code لامل ښیي، او error یې په کلمو بیانوي.
codestringاړین

ولې غوښتنه رد شوه، د یو ثابت کوډ په توګه چې پر بنسټ یې پرېکړه کولی شئ: د بېلګې په توګه insufficient_scope (403)، rate_limited (429) او، د کارونې له مخې بیل کېدونکي پېرودونکي لپاره، spend_cap_reached (402) او metered_billing_inactive (402).

errorstringاړین

بېلګه

د کوډ بېلګې ژبه

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";
}

کتابتون غوره بولئ؟ د کتابتونونو برخه وګورئ.

که یوه ژباړه له انګلیسي مرجع سره توپیر ولري، انګلیسي مرجع سمه ده.