OpenAPI
OpenAPI هو مخطط مقروء آليًا يصف كل نقطة ومعامل واستجابة في واجهة REST، ويمكن توليد العملاء منه.
بالتفصيل
ينشر هذا API وثيقة OpenAPI 3.1 إلى جانب فهرس llms.txt، وهو ما يتيح لمولّد SDK أو مجموعة Postman أو إطار وكلاء فهم الواجهة دون أن يقرأ أحد نصًا أولًا. وهو مرجع الحقيقة لأشكال الطلبات ورموز الحالة. والتغييرات السلوكية تُعلن في سجل التغييرات قبل إطلاقها، فيمكن إعادة توليد العميل عن قصد بدل اكتشافه معطلًا.
يُعرف أيضًا بـ
- swagger
- api schema