py-fastapi-patterns
بناء أنماط موثوقة لواجهات API باستخدام FastAPI
غالبا ما تنحرف مشاريع FastAPI إلى مسارات واستجابات ومخططات غير متسقة. تمنحك هذه المهارة أنماطا عملية لنقاط النهاية، والتحقق، والأخطاء، والبرمجيات الوسيطة، وOpenAPI.
التثبيت باستخدام Agent لدي
انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.
Review the Skillstore skill "py-fastapi-patterns" from https://skillstore.io/skills/cjharmath-py-fastapi-patterns.md and its manifest at https://skillstore.io/api/skills/cjharmath-py-fastapi-patterns/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.
موارد مهيّأة لـ Agents
استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.
اختبرها
جارٍ استخدام "py-fastapi-patterns". يسأل مستخدم عن نقطة نهاية جديدة لإنشاء تقييم.
النتيجة المتوقعة:
توضح الاستجابة الاعتماديات الخاصة بالمستخدم النشط والجلسة، ونموذج طلب تم التحقق منه، ونموذج استجابة مصفى، وسلوكيات واضحة لـ 201 و422.
جارٍ استخدام "py-fastapi-patterns". يجد مراجع أن أنواع الواجهة الأمامية المولدة تتضمن حقول مستخدم خاصة.
النتيجة المتوقعة:
تحدد الاستجابة نماذج الاستجابة المفقودة، وتوصي بمخططات قراءة عامة، وتشرح كيف يرشح FastAPI الكائنات المعادة لعملاء OpenAPI.
جارٍ استخدام "py-fastapi-patterns". يرى فريق أن /users/me تتم معالجته بواسطة /users/{user_id}.
النتيجة المتوقعة:
تشرح الاستجابة ترتيب المسارات، وتضع المسارات المحددة قبل المسارات ذات المعاملات، وتوصي بأنواع معاملات أقوى مثل UUID.
التدقيق الأمني
آمنAll static command-execution hits are Markdown fences, inline code, or optional local detection commands in SKILL.md rather than executable skill logic. The network and system-reconnaissance hits are documentation URLs, localhost examples, or normal API samples; no prompt injection or malicious intent was found.
عوامل الخطر
⚙️ الأوامر الخارجية (22)
🌐 الوصول إلى الشبكة (3)
شارك واستشهد بهذا التقرير
شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.
نسخ رابط التقرير
https://skillstore.io/skills/cjharmath-py-fastapi-patterns/audits/7?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportشارة Markdown
[](https://skillstore.io/skills/cjharmath-py-fastapi-patterns?utm_source=security_passport_badge)شارة HTML
<a href="https://skillstore.io/skills/cjharmath-py-fastapi-patterns?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/cjharmath-py-fastapi-patterns/security.svg" alt="Skillstore security assessment" loading="lazy"></a>بطاقة قابلة للتضمين
<iframe src="https://skillstore.io/embed/skills/cjharmath-py-fastapi-patterns.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
CJHarmath. (2026). py-fastapi-patterns security audit report (audit version 7) [Author version unspecified]. Skillstore. https://skillstore.io/skills/cjharmath-py-fastapi-patterns/audits/7اقتباس BibTeX
@techreport{cjharmath-cjharmath-py-fastapi-patterns-2026,
author = {CJHarmath},
title = {py-fastapi-patterns security audit report (audit version 7)},
institution = {Skillstore},
year = {2026},
number = {7},
url = {https://skillstore.io/skills/cjharmath-py-fastapi-patterns/audits/7},
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: "py-fastapi-patterns security audit report (audit version 7)"
version: "unspecified"
type: report
authors:
- name: "CJHarmath"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/cjharmath-py-fastapi-patterns/audits/7"
identifiers:
- type: other
value: "skillstore:cjharmath-py-fastapi-patterns:audit:7"
description: "Skillstore immutable audit report identifier"
تقييم Skillstore
سبب هذا التقييم موثوقية الأدلة: مرتفعما الذي يمكنك بناؤه
تصميم نقاط نهاية API جديدة
إنشاء نقاط نهاية باعتماديات نظيفة، ونماذج استجابة، وتحقق، ورموز حالة متوقعة.
تحسين توليد كود الواجهة الأمامية
تنظيف مخططات OpenAPI بحيث تعرض العملاء المولدة أنواعا مستقرة وبيانات وصفية مفيدة لنقاط النهاية.
مراجعة طلبات السحب في FastAPI
فحص ترتيب المسارات، وتصفية الاستجابات، وموضع البرمجيات الوسيطة، ومشكلات التكامل الشائعة.
جرّب هذه الموجّهات
استخدم هذه المهارة لتصميم نقطة نهاية FastAPI لـ [resource]. ضمّن الاعتماديات، والتحقق من الطلب، وresponse_model، ورموز الحالة المتوقعة.
راجع مسارات FastAPI الخاصة بي بحثا عن استخدام مفقود أو ضعيف لـ response_model. اشرح الحقول التي قد تتسرب واقترح مخططات استجابة أكثر أمانا.
حلل مسارات FastAPI هذه بحثا عن مشكلات ترتيب المسارات، ومشكلات معاملات المسار، وفجوات التحقق من الاستعلام، واستجابات الأخطاء غير المتسقة.
استخدم هذه المهارة لتحسين مخطط OpenAPI الخاص بي لتوليد كود الواجهة الأمامية. ركز على الأوصاف، والأمثلة، والتقسيم إلى صفحات، والأخطاء، وتنظيم الموجهات.
أفضل الممارسات
- عرّف نماذج الاستجابة على المسارات العامة لمنع كشف الحقول عن طريق الخطأ.
- ضع المسارات المحددة قبل المسارات ذات المعاملات حتى يطابق FastAPI نقطة النهاية المقصودة.
- حافظ على دقة أوصاف OpenAPI وأمثلته واستجابات الأخطاء للعملاء المولدين.
تجنب
- إرجاع نماذج ORM مباشرة من نقاط النهاية العامة دون مخطط استجابة مصفى.
- استخدام معاملات مسار نصية واسعة عندما يكون النوع المقيد أو enum أكثر أمانا.
- التعامل مع مخرجات OpenAPI المولدة كفكرة لاحقة بعد تعطل تكامل الواجهة الأمامية.