العودة إلى الفهرس / أدوات التطوير
تصميم API: اجعل الموارد ودلالات القراءة والكتابة قابلة للتطور
راجع موارد REST أو GraphQL وطرق HTTP والمخططات وتوافق المستهلكين.
المهارات
أحصِ مستهلكي API وأسماء الموارد وتسلسلها وعمليات القراءة والكتابة قبل اختيار بنية REST أو GraphQL. استخدم موارد اسمية ودلالات HTTP الصحيحة: GET آمن ومتكرر، وPOST ينشئ، وPUT يستبدل، وPATCH يعدل جزئياً، وDELETE يحذف. في GraphQL استخدم أنواع المخطط وميز الاستعلامات عن الطفرات. وحد توحيد الصفحات والأخطاء والمصادقة ومفاتيح تكرار الطلب. افحص أثر الحقول أو القيم الجديدة على العملاء السابقين واكتب أمثلة OpenAPI/GraphQL وخطة ترحيل متوافقة؛ فالمواصفة ليست عقداً منشوراً.
الصلاحيات
المتطلبات السابقة
- لتصميم أو مراجعة واجهات REST أو GraphQL وحدود الموارد والأخطاء والتوافق.
- حدد المستهلكين والموارد والقراءة والكتابة ومتطلبات التوافق.
الصلاحيات
- يمكنها تعديل مخطط الواجهة والوثائق؛ ولا يعني تغيير المواصفة أنها نُشرت.
- يتطلب التنفيذ أو تغيير التوافق الإنتاجي تفويضاً منفصلاً.
القيود
حافظ على دلالة GET الآمنة والمتكررة؛ ومثّل الكتابة عبر POST/PUT/PATCH/DELETE مع حماية المستهلكين عند التطور.
المصدر الأصلي المثبت
- المستودع
- wshobson/agents
- مسار الملف
- plugins/backend-development/skills/api-design-principles/SKILL.md
- الإيداع المثبت
46891e7e60da0e52baf1050b7b6391b64e84c6d9- تاريخ فحص المصدر
- 2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت
مقاييس المستودع
تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.
- النجوم
- لم يُجمع
- التفرعات
- لم يُجمع
- وقت الرصد
- لم يُجمع
لا تتوفر لقطة مقاييس بعد.
الترخيص: MIT
الأدوات المتوافقة
API specification editor · OpenAPI schema · GraphQL schema review
الموضوع الرئيسي
انقل مساعد البرمجة من فهم السياق إلى التحقق من التغيير