واجهات API: عقد بين برنامجين

## الفكرة

الواجهة تحدد طلبات واستجابات وأخطاء ومصادقة، وتسمح لأنظمة تتغير داخليًا مع الحفاظ على عقد مستقر.

## الآلية

REST قد يستخدم موارد وHTTP، وهناك GraphQL وRPC. الأهم مخطط واضح وإصدارات وحدود معدل وإعادة محاولة آمنة.

## حالة

طلب إنشاء مدفوعات لا يجب تكراره بلا مفتاح idempotency إذا انقطع الرد؛ ربما نجح الخادم وضاع الجواب.

## أداة عملية

اقرأ التوثيق، اختبر في sandbox، سجل معرّف الطلب دون أسرار، وتعامل مع 429 و5xx بسياسة تراجع.

## محاذير

تضمين مفتاح في تطبيق عام، افتراض كل 200 نجاح منطقي، إعادة محاولة فورية، وكسر عملاء بتغيير حقل.

## سؤال للنقاش

ما الدليل الإضافي الذي تحتاجه قبل تطبيق فكرة «واجهات API: عقد بين برنامجين» أو تعميمها؟

## المراجع

- NIST ومعايير التقنية والأمن.
- IETF وW3C والتوثيق المعياري للويب.