تصميم واجهات REST وGraphQL API موثوقة
غالبا ما تواجه فرق API صعوبات مع نقاط نهاية غير متسقة، ومخططات غير واضحة، ونماذج أخطاء ضعيفة، وتغييرات تصميم متأخرة. تمنح هذه المهارة Claude وCodex وClaude Code إرشادات عملية لتخطيط ومراجعة وتوثيق واجهات REST وGraphQL API.
انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.
Review the Skillstore skill "api-design-principles" from https://skillstore.io/skills/wshobson-api-design-principles.md and its manifest at https://skillstore.io/api/skills/wshobson-api-design-principles/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.
استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.
جارٍ استخدام "api-design-principles". راجع مقترح نقطة نهاية لإدارة المستخدمين.
النتيجة المتوقعة:
جارٍ استخدام "api-design-principles". صمم مخطط طلبات GraphQL.
النتيجة المتوقعة:
جارٍ استخدام "api-design-principles". حضّر قائمة تحقق API قبل التنفيذ.
النتيجة المتوقعة:
Most static findings are false positives from Markdown examples, GraphQL identifier fields, sample URLs, and HTTP status documentation. One real issue remains: the FastAPI asset presents production guidance while using permissive host, CORS, and bind-address defaults.
هذه قدرات محلية حقيقية قد يُتوقع وجودها لهذه المهارة، لذا فهي تتطلب مراجعة ولكن لا تُحتسب كسلوك خبيث مؤكد.
شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.
https://skillstore.io/skills/wshobson-api-design-principles/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/wshobson-api-design-principles?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/wshobson-api-design-principles?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/wshobson-api-design-principles/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/wshobson-api-design-principles.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>wshobson. (2026). api-design-principles security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/wshobson-api-design-principles/audits/8@techreport{wshobson-wshobson-api-design-principles-2026,
author = {wshobson},
title = {api-design-principles security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/wshobson-api-design-principles/audits/8},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "api-design-principles security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "wshobson"
date-released: "2026-07-07"
url: "https://skillstore.io/skills/wshobson-api-design-principles/audits/8"
identifiers:
- type: other
value: "skillstore:wshobson-api-design-principles:audit:8"
description: "Skillstore immutable audit report identifier"
تبقى مهارة كل مؤلف عنصراً مستقلاً قابلاً للتثبيت. يُرتب المتغير الموصى به وفق أدلة Skillstore.
سبب تصدر هذا المتغير
sickn33-api-design-principles
2026-09-09
wshobson-api-design-principles
2026-09-09
استخدم إرشادات REST وGraphQL لاختيار أسماء الموارد، والمخططات، والتقسيم إلى صفحات، والأخطاء، والإصدارات قبل التنفيذ.
قارن مقترح API بقائمة التحقق للعثور على طرق غير متسقة، أو أخطاء مفقودة، أو تقسيم ضعيف إلى صفحات، أو توثيق غير واضح.
حوّل الأنماط المضمنة إلى قواعد داخلية لتسمية نقاط النهاية، وشكل طفرة GraphQL، والإهمال التدريجي، وتنسيقات الاستجابة.
Review these REST endpoints for resource naming, HTTP methods, status codes, pagination, and error handling. Suggest concrete improvements: [paste endpoints].
Design a REST API for [domain]. Include resources, endpoints, request and response shapes, pagination, filtering, status codes, and versioning guidance.
Review this GraphQL schema for type design, nullable fields, mutations, pagination, authorization boundaries, and N+1 risks: [paste schema].
Create API design standards for a team building REST and GraphQL services. Include naming, versioning, errors, security checks, documentation, and review criteria.
المؤلف
wshobsonالترخيص
MIT
مراجعة Skillstore
r1
تنبيه الإصدار
لم يعلن المؤلف عن إصدار.
مرجع
36e07d5e13068e5be64447e8f20b427cf2cbd21a
حداثة الصيانة
٢٥/٧/٢٠٢٦
الاستخدام
14 تنزيلات · 412 مشاهدات
بنية الملفات
تحسين مطالبات LLM للإنتاج
غالبًا ما تفشل مطالبات LLM لأن التعليمات والأمثلة ومعايير التقييم تكون غير واضحة. توفر هذه المهارة قوالب وسير عمل لتحسين المطالبات في Claude وCodex وClaude Code والأدوات المشابهة.
إدارة التطوير المعتمد على السياق
تفقد المشاريع المدعومة بالذكاء الاصطناعي اتساقها عندما تكون أهداف المنتج، وخيارات الحزمة التقنية، وقواعد سير العمل مبعثرة. ترشد هذه المهارة Claude وCodex وClaude Code عبر عناصر سياق Conductor.
بناء نماذج مالية للشركات الناشئة
تحتاج فرق الشركات الناشئة إلى توقعات واضحة قبل أن تتمكن من تخطيط التوظيف وجمع التمويل واستخدام النقد. تنظم هذه المهارة الإيرادات والتكاليف ومدى كفاية النقد والسيناريوهات في مخرجات عملية للتخطيط المالي.
تصميم لوحات مؤشرات أداء رئيسية تقود القرارات
غالبا ما تبني الفرق لوحات معلومات تعرض الكثير من الأرقام لكنها لا توجه إلى اتخاذ إجراء. تساعد هذه المهارة Claude وCodex وClaude Code على اختيار مؤشرات أداء رئيسية ذات معنى، وتنظيم طرق العرض، وعرض المقاييس بوضوح.
كتابة تقارير ما بعد الحوادث بلا لوم
غالبا ما تصبح مراجعات الحوادث غير متسقة، أو مركزة على اللوم، أو صعبة التنفيذ. تساعد هذه المهارة Claude وCodex وClaude Code على صياغة تقارير منظمة لما بعد الحوادث مع جداول زمنية واضحة، وأسباب جذرية، ومالكين محددين.
بناء قصص بيانات واضحة
غالبا ما تفشل المقاييس الخام في إقناع أصحاب المصلحة أو دعم القرارات. تساعد هذه المهارة Claude وCodex وClaude Code على تحويل التحليل إلى سرديات واضحة ومرئيات وتوصيات.
تصميم واجهات REST وGraphQL موثوقة
بواسطة AutumnsGrove
تحتاج فرق API إلى نقاط نهاية ومصادقة وتوثيق متسقة. ترشد هذه المهارة قرارات تصميم REST وGraphQL وOpenAPI وإدارة الإصدارات والأمان.
تصميم عقود API جاهزة للإنتاج
بواسطة ArieGoldkin
غالبا ما تصمم الفرق واجهات API بموارد وأخطاء وإصدارات غير متسقة. توفر هذه المهارة أنماطا وقوائم تحقق وقوالب للعمل على REST وGraphQL وgRPC وOpenAPI وAsyncAPI.
صمّم عقود API أفضل
بواسطة CloudAI-X
تحتاج فرق API إلى عقود متسقة قبل التنفيذ. ترشد هذه المهارة اختيارات REST وGraphQL وOpenAPI والأخطاء وإدارة الإصدارات والأمان.
إنشاء واجهات API باستخدام FastAPI بأنماط قابلة لإعادة الاستخدام
بواسطة 0xDarkMatter
تحتاج مشاريع FastAPI إلى اختيارات متسقة للتحقق من الصحة، والتبعيات، والبرمجيات الوسيطة، والعمل في الخلفية. تمنح هذه المهارة Claude وCodex وClaude Code أنماطًا قابلة لإعادة الاستخدام لتطوير واجهات API عملية بلغة Python.
تصميم REST وGraphQL APIs بشكل أفضل
بواسطة supercent-io
تحتاج فرق API إلى عقود متسقة قبل بدء التنفيذ. ترشد هذه المهارة تصميم الموارد، وتنسيقات الطلبات، والأخطاء، وإدارة الإصدارات، والتوثيق.
بناء واجهات API خلفية موثوقة
بواسطة alirezarezvani
غالبًا ما تحتاج مشاريع الواجهة الخلفية إلى تخطيط متسق عبر APIs وقواعد البيانات والأمان والنشر. تمنح هذه المهارة Claude وCodex وClaude Code إرشادات منظمة للواجهة الخلفية مع سكربتات مساعدة بسيطة ومراجع.