المطوّرون · مرجع واجهة البرمجة
توثيق واجهة التقييمات
دليل لقراءة استجابة dispatch.evals وفهم تصنيف مصادرها وحدود تفسيرها. هذه الصفحة مرجع للحقول، ولا تعرض تقرير أداء.
طلب قراءة لواجهة التقييمات
curl 'https://steadywrk.app/api/dispatch/analytics/evals?period=rolling_30d'قراءة الحقول
- schema_version · period
- يحددان صيغة الاستجابة والفترة المطلوبة. اسم الفترة لا يثبت أن كل حقل يمثل قياساً أُجري خلالها.
- estimated · provenance.by_field
- العلامة العامة estimated لا تصف مصدر كل حقل. اقرأ provenance.by_field لمعرفة تصنيف المصدر الخاص بالحقل الذي تفسّره.
- methodology
- اقرأ تعريف الحقل والاستبعادات وحدود الفترة معاً قبل تفسير الاستجابة. لا يغني الملخص عن المنهجية.
- operational.latency_source · operational.pricing_latency_source
- لكل نوع من التوقيت تصنيف مصدر مستقل. لا تستخدم تصنيف أحد الحقلين لاستنتاج مصدر الآخر.
- trust_signals.build_hash
- يعرّف إصدار البرنامج الذي يخدم الاستجابة. معرّف البناء لا يثبت دقة البيانات أو حداثتها.
تصنيف المصادر وحدود التفسير
- canonical_estimate
- تقدير مرجعي من السجل، وليس قياساً للفترة المطلوبة.
- live_telemetry
- تصنّف الاستجابة هذا الحقل على أنه مستمد من ملاحظات. راجع تعريفه والطابع الزمني المرتبط به قبل تفسيره.
- unavailable
- لا تتوفر قراءة مؤهلة لهذا الحقل. القيمة null تعني أن القراءة غير متاحة، ولا تعني صفراً.
الاستجابة إفادة ذاتية، وليست تدقيقاً مستقلاً أو لقطة موقّعة. نجاح الطلب لا يثبت نجاح خدمة، ولا يشكّل ضماناً للأداء. اقرأ methodology و provenance.by_field معاً.
تخضع الطلبات لحدود الاستخدام. تعامل مع استجابات إعادة المحاولة وترويساتها؛ وقد لا تعكس الاستجابة المخزّنة مؤقتاً أحدث الملاحظات المتاحة.