# سياق API لإعداد AGENTO

## الهدف والنطاق
- ما الذي يريد المستخدم فعله؟
- ما العملية الأولى التي سنربطها؟

## المصادر والإصدار
- رابط أو اسم ملف التوثيق:
- `operationId` أو route:
- تاريخ مراجعة متطلبات الـ API:

## أول Endpoint
- method: UNKNOWN
- العنوان الكامل: UNKNOWN
- هل تغيّر العملية بيانات؟ UNKNOWN

## حقول الطلب ومصدر كل قيمة
لكل حقل، سجّل اسمه في API، ونوعه، وموضعه في `path` أو `query` أو `body`، وهل هو مطلوب، ومصدر قيمته، والقيود المثبتة في التوثيق. لا تكتب قيم بيانات الاعتماد.

## Auth وسياق الخادم
- نوع Auth:
- اسم Environment Variable إن لزم:
- البيانات التي يوفّرها الخادم بعد تسجيل الدخول:

## أمثلة الطلب والاستجابة
ضع مثالًا من API بعد إزالة البيانات الحساسة والبيانات الشخصية. ميّز بين عينة Response وتوثيق API يضمن وجود الحقول.

## الأخطاء المعروفة
الحالة، ومعناها، والإجراء المناسب في التطبيق.

## العلاقات والاختيارات
ما الـ Endpoint التي توفر الـ IDs؟ ما مسار القائمة؟ ما حقل ID وما حقل العرض؟

## عمليات الكتابة والـ Confirmation
ما البيانات التي تتغير؟ ما الذي يراجعه المستخدم؟ هل تدعم API idempotency؟ اكتب UNKNOWN إذا لم يوجد دليل.

## المعلومات الناقصة والافتراضات
لا تحوّل هذه النقاط إلى إعدادات تنفيذ قبل مراجعتها.

## تجربة القبول المتوقعة
طلب ناجح معروف، ومدخلاته، والنتيجة المتوقعة، وتجربة غياب مدخل مطلوب.