تطوير واجهات REST API
في هذا الدرس 4 موضوعات
هذا الدرس مخطط له. يعرض المخطط أدناه الموضوعات التي سيغطيها، ولم يُنشر الدرس الكامل بعد.
نص الدروس والتمارين باللغة الإنجليزية، بينما تبقى واجهة الموقع وعناوين الدروس بالعربية.
في هذا الدرس
change a REST API without breaking clients.
الموضوعات المخطط لها
- Prefer additive change: add the new field next to the old one.
- Expand and contract: add new, migrate consumers, remove old in a later release.
- A new version (
/v2, media type, header) is for changes that cannot be made additively; do not version every change. - Keep error shapes stable (for example RFC 9457 problem details).
- Verify compatibility automatically: contract tests (MID-045) and OpenAPI diff tools in CI.
تفاصيل المخطط المبدئي
عرض عملي
total stays; add money: {amount: "12.50", currency: "EUR"}. Both are returned for one release.
اختبر فهمك
What are the three phases of expand and contract?
أظهر الإجابة
Expand: add new; migrate consumers; contract: remove old.
التطبيق
طبّق هذا الدرس بمختبر الوحدة وتمارينها واختبارها.
تعليم الدرس كمكتمل اختياري ويمكنك التراجع عنه في أي وقت. يبقى تقدمك محفوظًا في هذا المتصفح.