kiota
v1.21.0
Kiota هي أداة سطر أوامر لإنشاء عميل API للاتصال بأي واجهة برمجة تطبيقات موصوفة لـ OpenAPI تهتم بها. الهدف هو التخلص من الحاجة إلى الاعتماد على API SDK مختلف لكل واجهة برمجة تطبيقات تحتاج إلى الاتصال بها. يوفر عملاء Kiota API تجربة مكتوبة بقوة مع جميع الميزات التي تتوقعها من API SDK عالي الجودة، ولكن دون الحاجة إلى تعلم مكتبة جديدة لكل HTTP API.
تعتمد هذه المكتبة على مكتبة Microsoft.OpenAPI.NET لضمان الدعم الشامل لواجهات برمجة التطبيقات التي تستخدم أوصاف OpenAPI. أحد أهداف المشروع هو توفير أفضل دعم ممكن لمولد الأكواد لميزات OpenAPI وJSON Schema. يصف التوثيق المفاهيمي كيفية عمل kiota والمفاهيم عالية المستوى، ويوثق هذا الملف التمهيدي كيفية البدء باستخدام Kiota.
يقدم الجدول التالي نظرة عامة على اللغات التي يدعمها Kiota والتقدم المحرز في تنفيذ المكونات المختلفة.
| لغة | جيل | التجريدات | التسلسل | المصادقة | HTTP | الأدوات والتبعيات المطلوبة |
|---|---|---|---|---|---|---|
| سطر الأوامر | (انظر سيشارب) + | (انظر سي شارب) | (انظر سي شارب) | (انظر سي شارب) | وصلة | |
| سيشارب | ✔ | ✔ | النموذج، JSON، متعدد الأجزاء، النص | مجهول، مفتاح API، Azure | ✔ | وصلة |
| دارت | ◀ | النموذج، ◀ JSON، ◀ متعدد الأجزاء، النص | مجهول، مفتاح API | |||
| يذهب | ✔ | ✔ | النموذج، JSON، متعدد الأجزاء، النص | مجهول، مفتاح API، Azure | ✔ | وصلة |
| جافا | ✔ | ✔ | النموذج، JSON، متعدد الأجزاء، النص | مجهول، مفتاح API، Azure | ✔ | وصلة |
| PHP | ✔ | ✔ | JSON، النموذج، متعدد الأجزاء، النص | مجهول، ✔️ دوري PHP | ✔ | وصلة |
| بايثون | ✔ | ✔ | النموذج، JSON، متعدد الأجزاء، النص | مجهول، أزور | ✔ | وصلة |
| روبي | النموذج، JSON، متعدد الأجزاء، النص | مجهول، OAuth2 | ||||
| سويفت | النموذج، JSON، النموذج، النص | مجهول، أزور | ||||
| تايب سكريبت/جافا سكريبت | النموذج، JSON، متعدد الأجزاء، النص | مجهول، مفتاح API، Azure، SPFx | وصلة |
وسيلة الإيضاح: ✔ -> مستقر، -> قيد المعاينة، -> لم يبدأ، ▶ -> قيد التقدم.
تم توثيق المعلمات هنا.
تأكد من تثبيت المتطلبات المسبقة أولاً. إذا كنت تستخدم Visual Studio Code باعتباره IDE الخاص بك، فإن ملف Launch.json يحتوي بالفعل على التكوين اللازم لتشغيل Kiota. افتراضيًا، سيستخدم هذا التكوين openApiDocs/v1.0/Mail.yml ضمن مستودع PowerShell باعتباره OpenAPI لإنشاء SDK لـ. افتراضيًا، سيقوم هذا التكوين بإخراج الملفات التي تم إنشاؤها في مجلد graphdotnetv4|graphjavav4|graphtypescriptv4 الموجود في المجلد الأصلي الذي تم استنساخ هذا المستودع فيه.
سيؤدي تحديد اللغة التي تريد إنشاء عميل API لها في علامة التبويب Visual Studio Debug والضغط على F5 إلى إنشاء عملية تصحيح الأخطاء وبدءها وإرفاقها بـ Kiota تلقائيًا.
يمكنك العثور على نماذج من العملاء الذين تم إنشاؤها باستخدام Kiota في مستودع عينات Kiota.
يمكن العثور على مثال لتطبيق يتصل بواجهة برمجة تطبيقات متعددة في KiotaApp repo
يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تعلن أن لديك الحق في منحنا حقوق استخدام مساهمتك، بل وتفعل ذلك بالفعل. للحصول على التفاصيل، تفضل بزيارة https://cla.opensource.microsoft.com.
عند إرسال طلب سحب، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA وتزيين العلاقات العامة بشكل مناسب (على سبيل المثال، التحقق من الحالة، والتعليق). ما عليك سوى اتباع التعليمات التي يقدمها لك الروبوت. سوف تحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع اتفاقيات إعادة الشراء باستخدام CLA الخاصة بنا.
اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.
قد يحتوي هذا المشروع على علامات تجارية أو شعارات للمشاريع أو المنتجات أو الخدمات. يخضع الاستخدام المصرح به للعلامات التجارية أو الشعارات الخاصة بشركة Microsoft ويجب أن يتبع إرشادات العلامة التجارية والعلامات التجارية الخاصة بشركة Microsoft. يجب ألا يتسبب استخدام العلامات التجارية أو الشعارات الخاصة بشركة Microsoft في الإصدارات المعدلة من هذا المشروع في حدوث ارتباك أو الإشارة ضمنًا إلى رعاية Microsoft. ويخضع أي استخدام لعلامات تجارية أو شعارات تابعة لجهات خارجية لسياسات تلك الجهات الخارجية.
