الانتقال إلى المحتوى الرئيسي
GET
/
faults
عرض قائمة بكل الأعطال
curl --request GET \
  --url https://api.altostrat.io/faults \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "flt_31pkd1t8FvW7qZv0jG2a9kH5mB1",
      "resource_id": "dev_2j4k2l2j3k4l2j3k4",
      "customer_id": "cus_1i2j3k4l5m6n7o8p",
      "microservice_id": "wantunnel-monitor",
      "type": "wantunnel",
      "status": "unresolved",
      "severity": "CRITICAL",
      "message": "فشل في تجاوز رابط WAN: الرابط الأساسي (WAN1) معطل",
      "cause": "فشل الاختبار: تجاوز زمن الاستجابة عتبة 500 مللي ثانية",
      "created_at": "2025-10-21T12:00:00.000000Z",
      "resolved_at": null,
      "resource_ancestry_path": "site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4",
      "ttl": 1797825595,
      "comments": [
        {
          "user_id": "user_a1b2c3d4e5f6g7h8",
          "comment": "تم الاتصال بمزود خدمة الإنترنت، وهم يحققون في انقطاع محلي.",
          "created_at": "2025-10-21T12:05:30.000000Z"
        }
      ]
    }
  ],
  "meta": {
    "count": 50,
    "cursor": "eyJQSyI6eyJTIjoiRkFVTFQjMzFwbGg4a2FhblB2R0h",
    "has_more": true
  }
}

Authorizations

Authorization
string
header
required

تتم مصادقة طلبات واجهة برمجة التطبيقات باستخدام رمز ويب JSON (JWT) يتم توفيره في ترويسة Authorization.

Query Parameters

limit
integer
default:50

حد لعدد الكائنات التي سيتم إرجاعها. يمكن أن يتراوح الحد بين 1 و 100، والافتراضي هو 50.

Required range: 1 <= x <= 100
cursor
string

مؤشر للاستخدام في تقسيم الصفحات. cursor هو سلسلة نصية مبهمة تحدد موقعك الحالي في القائمة.

Example:

"eyJQSyI6eyJTIjoiRkFVTFQjMzFwbGg4a2FhblB2R0h"

from
string<date-time>

طابع زمني بصيغة ISO 8601. يتم إرجاع الأعطال التي تم إنشاؤها بعد هذا الوقت فقط.

Example:

"2025-10-20T10:00:00Z"

to
string<date-time>

طابع زمني بصيغة ISO 8601. يتم إرجاع الأعطال التي تم إنشاؤها قبل هذا الوقت فقط.

Example:

"2025-10-21T10:00:00Z"

severity
enum<string>

تصفية الأعطال حسب مستوى خطورتها.

الخيارات المتاحة:
LOW,
MEDIUM,
HIGH,
CRITICAL,
WARNING
type
string

تصفية الأعطال حسب نوعها، مثل site أو wantunnel.

Example:

"wantunnel"

resource_id
string

تصفية الأعطال لمعرف مورد معين.

Example:

"dev_2j4k2l2j3k4l2j3k4"

site
string

تصفية الأعطال لموقع معين وجميع موارده الفرعية. يقوم هذا بإجراء استعلام هرمي.

Example:

"site_8a7b6c5d4e3f2g1h"

status
enum<string>

تصفية الأعطال حسب حالة حلها.

الخيارات المتاحة:
unresolved,
resolved

Response

قائمة مجزأة من الأعطال.

data
object[]
meta
object