Lingara API लाइब्रेरी
यह पेज अंग्रेज़ी से अनुवादित है। अगर दोनों में अंतर हो, तो अंग्रेज़ी पेज सही है। अंग्रेज़ी पेज पढ़ें
Lingara API लाइब्रेरी वही API कॉल करती हैं जिसका वर्णन रेफ़रेंस में है, उसी भाषा में जिसमें आप पहले से लिखते हैं। हर लाइब्रेरी एक ही स्पेसिफ़िकेशन से जनरेट होती है और एक ही कॉन्ट्रैक्ट निभाती है, इसलिए एक लाइब्रेरी में जो आप सीखते हैं वह बाकी सब पर भी लागू होता है:
- ऑथेंटिकेशन। आप क्लाइंट को अपना क्लाइंट ID और सीक्रेट एक बार देते हैं। वह उन्हें एक्सेस टोकन से बदलता है, उसे कैश करता है, उसकी समय-सीमा खत्म होने से कुछ पहले उसे रीफ़्रेश करता है, और अगर API 401 लौटाए तो नए टोकन के साथ कॉल को एक बार फिर से आज़माता है।
- स्ट्रीम। स्ट्रीम करने वाले ऑपरेशन, जैसे शब्दावली बनाना, भाषा के अपने तरह के इटरेटर के रूप में आते हैं। लाइब्रेरी इवेंट्स को पार्स करती है और स्ट्रीम पूरी होने पर इटरेशन खत्म कर देती है।
- एरर। हर विफलता चार एरर में से एक होती है जिनका बेस टाइप साझा है, इसलिए एक ही हैंडलर उन सबको पकड़ सकता है।
- रीट्राई। कोई 429 या 503 जो बताता है कि कितनी देर इंतज़ार करना है, एक सीमा तक आपके लिए फिर से आज़माया जाता है। बाकी सब कुछ तुरंत उठा दिया जाता है।
इन पेजों पर हर कोड उदाहरण लाइब्रेरी के किसी रिलीज़ किए गए संस्करण से लिया गया है, जहाँ उसे शिप होने से पहले कंपाइल और टेस्ट किया जाता है।
इंस्टॉल करें
नीचे अपनी भाषा चुनें। हर भाषा का अपना पेज है जिसमें पहली कॉल दी गई है, और लाइब्रेरी का उपयोग के अंतर्गत आने वाले पेज हर व्यवहार को और विस्तार से समझाते हैं।
TypeScript
npm install @lingara/api@0.1.0-alpha.6Rust
cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-threadGo
go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6Java
<dependency>
<groupId>com.getlingara</groupId>
<artifactId>lingara-java</artifactId>
<version>0.1.0-alpha.6</version>
</dependency>Kotlin
implementation("com.getlingara:lingara-kotlin:0.1.0-alpha.6")Ruby
gem install lingara -v 0.1.0-alpha.6PHP
composer require spinningcatstudios/lingara:0.1.0-alpha.6भाषाएँ
- TypeScript
Node.js के लिए Lingara API लाइब्रेरी, npm पर प्रकाशित।
- Rust
async Rust के लिए Lingara API लाइब्रेरी, crates.io पर प्रकाशित।
- Go
Go के लिए Lingara API लाइब्रेरी, एक मॉड्यूल जिसकी स्टैंडर्ड लाइब्रेरी के बाहर कोई डिपेंडेंसी नहीं है।
- Java
Java 17 और उसके बाद के संस्करणों के लिए Lingara API लाइब्रेरी, Maven Central पर प्रकाशित।
- Kotlin
JVM पर Kotlin के लिए Lingara API लाइब्रेरी, coroutines पर बनी।
- Ruby
Ruby के लिए Lingara API लाइब्रेरी, एक gem जिसकी कोई रनटाइम डिपेंडेंसी नहीं है।
- PHP
PHP 8.2 और उसके बाद के संस्करणों के लिए Lingara API लाइब्रेरी, Packagist पर प्रकाशित।
लाइब्रेरी का उपयोग
- ऑथेंटिकेशन
हर लाइब्रेरी आपके क्लाइंट ID और सीक्रेट को एक्सेस टोकन में कैसे बदलती है, और उन्हें ताज़ा कैसे रखती है।
- स्ट्रीम
लाइब्रेरी स्ट्रीम किए गए नतीजे कैसे देती हैं, और कोई स्ट्रीम कब खत्म या विफल होती है।
- एरर और रीट्राई
हर लाइब्रेरी जो चार एरर उठाती है, और कौन-सी विफलताएँ वह आपके लिए फिर से आज़माती है।