Metrics Window Out Of Range

metrics-window-out-of-range · 400

طلب مشغل من مسار مقاييس نافذة لا يقبلها، فلم تحسب الـ API شيئا.

كل الصفحات

المقاييس يقرؤها مشغلو غيم عبر المسارات الإدارية. والنافذة عدد صحيح من الساعات أو الأيام، مثل 48h أو 30d، من ساعة حتى maxWindowHours، أي 8,760 ساعة أو 365 يوما. ودونها، يقرأ المسار 30d.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع window و maxWindowHours.

الأسباب الشائعة

  • النافذة أطول من 365 يوما، مثل 400d.
  • النافذة أقصر من ساعة، مثل 0h.

كيف تصلح الطلب

  • اطلب نافذة 365d على الأكثر، بالـ h أو الـ d.
  • أزل النافذة لتقرأ آخر 30 يوما.

مثال على الرد

json
{
  "type": "metrics-window-out-of-range",
  "title": "Metrics Window Out Of Range",
  "detail": "A window of '400d' is longer than the 8760h (365d) maximum this endpoint scans. Ask for a shorter window.",
  "window": "400d",
  "maxWindowHours": 8760,
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/admin/metrics/one-shot-rate",
  "method": "GET",
  "instance": "GET /v1/admin/metrics/one-shot-rate",
  "status": 400,
  "docs": "https://ghaym.me/docs/errors/metrics-window-out-of-range"
}