openapi-to-typescript
إنشاء TypeScript من مواصفات OpenAPI
تحتاج فرق API إلى نماذج TypeScript تبقى متوافقة مع عقود OpenAPI. تحول هذه المهارة مواصفات OpenAPI 3.0 إلى واجهات، وأنواع نقاط نهاية، وحراس وقت تشغيل.
التثبيت باستخدام Agent لدي
انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.
Review the Skillstore skill "openapi-to-typescript" from https://skillstore.io/skills/softaworks-openapi-to-typescript.md and its manifest at https://skillstore.io/api/skills/softaworks-openapi-to-typescript/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.
موارد مهيّأة لـ Agents
استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.
اختبرها
جارٍ استخدام "openapi-to-typescript". مواصفة OpenAPI 3.0 لفهرس منتجات تحتوي على مخططات Product و Order.
النتيجة المتوقعة:
ملف TypeScript يحتوي على واجهات Product و Order، وأنواع طلبات واستجابات نقاط النهاية، وحراس أنواع، ونوع خطأ API.
جارٍ استخدام "openapi-to-typescript". مواصفة خدمة تحتوي على حقول تعداد، ومصفوفات، ومعاملات مسار.
النتيجة المتوقعة:
أنواع اتحاد منشأة للتعدادات، وأنواع خصائص المصفوفات، وأنواع طلبات المسارات، وتحذيرات للمراجع غير المدعومة في المخطط.
جارٍ استخدام "openapi-to-typescript". مستند OpenAPI غير صالح يفتقد قسم paths.
النتيجة المتوقعة:
رسالة تحقق تشرح حقل paths المفقود، من دون إنشاء ملف إخراج.
التدقيق الأمني
آمنAll 58 static findings were adjudicated as false positives. The external command alerts came from Markdown backticks, inline identifiers, JSON examples, and TypeScript examples rather than executable shell or Ruby code. The system reconnaissance alerts matched type-checking examples and OpenAPI validation text, and no prompt-injection or exfiltration intent was found.
عوامل الخطر
⚙️ الأوامر الخارجية (54)
شارك واستشهد بهذا التقرير
شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.
نسخ رابط التقرير
https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportشارة Markdown
[](https://skillstore.io/skills/softaworks-openapi-to-typescript?utm_source=security_passport_badge)شارة HTML
<a href="https://skillstore.io/skills/softaworks-openapi-to-typescript?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/softaworks-openapi-to-typescript/security.svg" alt="Skillstore security assessment" loading="lazy"></a>بطاقة قابلة للتضمين
<iframe src="https://skillstore.io/embed/skills/softaworks-openapi-to-typescript.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>الاستشهادات الأكاديمية (APA · BibTeX · CFF)
اقتباس APA
softaworks. (2026). openapi-to-typescript security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5اقتباس BibTeX
@techreport{softaworks-softaworks-openapi-to-typescript-2026,
author = {softaworks},
title = {openapi-to-typescript security audit report (audit version 5)},
institution = {Skillstore},
year = {2026},
number = {5},
url = {https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "openapi-to-typescript security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
- name: "softaworks"
date-released: "2026-07-07"
url: "https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5"
identifiers:
- type: other
value: "skillstore:softaworks-openapi-to-typescript:audit:5"
description: "Skillstore immutable audit report identifier"
تقييم Skillstore
سبب هذا التقييم موثوقية الأدلة: مرتفعما الذي يمكنك بناؤه
تكامل API في الواجهة الأمامية
حوّل مواصفات OpenAPI الخلفية إلى عقود TypeScript لجلب بيانات واجهة المستخدم ومعالجة الاستجابات.
عقود الخدمات المشتركة
انشر أنواع الطلبات والاستجابات المنشأة للفرق التي تستهلك واجهات API داخلية.
التحقق من الاستجابات في الاختبارات
استخدم حراس الأنواع المنشأة للتحقق من استجابات API في سير عمل الاختبارات المؤتمتة.
جرّب هذه الموجّهات
Generate TypeScript interfaces from ./openapi.json and save them to types/api.ts. Report validation errors before writing files.
Convert ./specs/service.yaml into TypeScript request, response, and schema types. Save the result to src/generated/api-types.ts.
Regenerate types from ./openapi.yaml, compare the result with src/types/api.ts, and summarize any breaking type changes.
Convert ./api/openapi.yaml and review oneOf, allOf, enums, arrays, and unresolved references. Flag areas needing manual review.
أفضل الممارسات
- تحقق من مواصفة OpenAPI قبل الإنشاء لإصلاح أخطاء العقد مبكرا.
- أعد إنشاء الأنواع كلما تغيرت مواصفة API المصدرية.
- راجع التحذيرات المتعلقة بالأنواع غير المعروفة، والمراجع الدائرية، ومخططات allOf المعقدة.
تجنب
- لا تعدل الملفات المنشأة يدويا عندما يمكن تحديث المواصفة المصدرية.
- لا تعامل حراس الأنواع المنشأة كتحقق كامل من قواعد العمل.
- لا تتجاهل المراجع غير المحلولة أو الأنواع غير المعروفة في الإخراج المنشأ.
الأسئلة المتكررة
ما إصدارات OpenAPI المدعومة؟
هل تنشئ عميل API كاملا؟
هل يمكنها قراءة مواصفات YAML و JSON؟
كيف يتم التعامل مع التعدادات؟
ماذا يحدث عندما تكون المواصفة غير صالحة؟
هل يمكنني اختيار ملف الإخراج؟
تفاصيل المطور
المؤلف
softaworksالترخيص
MIT
مراجعة Skillstore
r1
تنبيه الإصدار
لم يعلن المؤلف عن إصدار.
مرجع
f93e9bb0daca99badb6a7e574b97737155d57cb3
حداثة الصيانة
١٨/٧/٢٠٢٦
الاستخدام
7 تنزيلات · 269 مشاهدات