مكتبات Lingara API

هذه الصفحة مترجمة من الإنجليزية. إذا اختلفت النسختان، فالصفحة الإنجليزية هي الصحيحة. اقرأ الصفحة الإنجليزية

تستدعي مكتبات Lingara API الـ API نفسه الذي يصفه المرجع، باللغة التي تكتب بها أصلًا. كل مكتبة مولَّدة من المواصفة نفسها وتلتزم بالعقد نفسه، لذا فما تتعلمه في إحداها ينطبق على البقية:

• المصادقة. تعطي العميل معرّف العميل والسر مرة واحدة. فيستبدلهما برمز وصول، ويخزّنه مؤقتًا، ويجدّده قبل انتهاء صلاحيته بقليل، ويعيد محاولة الاستدعاء مرة واحدة برمز جديد إذا ردّ الـ API بـ 401.
• التدفقات. العمليات التي تبث نتائجها تدفقيًا، مثل توليد المفردات، تصل على شكل نوع المُكرِّر الخاص باللغة. تحلّل المكتبة الأحداث وتنهي التكرار عند انتهاء التدفق.
• الأخطاء. كل إخفاق هو واحد من أربعة أخطاء تشترك في نوع أساسي واحد، لذا يستطيع معالج واحد التقاطها جميعًا.
• إعادة المحاولة. الرد 429 أو 503 الذي يحدد مدة الانتظار تُعاد محاولته نيابةً عنك، حتى حدٍّ معين. وأي شيء آخر يُرفع فورًا.

كل مثال شيفرة في هذه الصفحات مأخوذ من إصدار منشور من المكتبات، حيث يُصرَّف ويُختبَر قبل طرحه.

التثبيت

اختر لغتك أدناه. لكل لغة صفحتها الخاصة مع أول استدعاء، والصفحات تحت استخدام المكتبات تشرح كل سلوك بمزيد من التفصيل.

npm install @lingara/api@0.1.0-alpha.6

cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-thread

go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6

<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

implementation("com.getlingara:lingara-kotlin:0.1.0-alpha.6")

gem install lingara -v 0.1.0-alpha.6

composer require spinningcatstudios/lingara:0.1.0-alpha.6