POSTمراجعv1
إرسال سؤال تحليلي محكوم
لا يقبل العقد SQL خامًا أو اختيار tenant من النص. يبني الخادم semantic plan فوق مقاييس معتمدة.
https://bi.foodtech-pos.com/api/v1/ai/questionsحالة العقد: مراجع
لا يُعد المسار عقدًا إنتاجيًا حتى يحمل حالة موثّق ويطابق المصدر التشغيلي.
المصادقة
المصادقةSigned SSO session or authorized service token
النطاق المطلوبbusiness · branch · permission
البيئةhttps://bi.foodtech-pos.com
آخر مراجعة١٦ يوليو ٢٠٢٦
الترويسات
AuthorizationمطلوبIdentity scheme depends on embedded or service mode.
Idempotency-KeyاختياريRecommended for metered asynchronous variants.
نموذج الطلب
أرسل سؤالًا بلغة طبيعية وسياق عرض غير حساس؛ أسماء الحقول تنتظر schema المنشورة.
{
"question": "<natural-language-question>",
"locale": "ar"
}نموذج الاستجابة
الإجابة يجب أن تربط المقاييس والفترة والجودة وأثر التدقيق دون ادعاء بيانات غير مسترجعة.
{
"answer": "<governed-answer>",
"correlation_id": "<opaque-id>",
"quality": "<certified-quality-state>"
}