अपना बचा हुआ भत्ता प्राप्त करें
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आवश्यक
उदाहरण
यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।