الانتقال إلى المحتوى الرئيسي
POST
/
faults
إنشاء عطل
curl --request POST \
  --url https://api.altostrat.io/faults \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "resource_id": "dev_2j4k2l2j3k4l2j3k4",
  "microservice_id": "manual-api-entry",
  "type": "wan-degradation",
  "severity": "HIGH",
  "message": "زمن استجابة رابط WAN مرتفع: زمن استجابة الرابط الأساسي (WAN1) مرتفع",
  "cause": "تجاوز اختبار زمن الاستجابة 250 مللي ثانية لمدة 5 فحوصات متتالية.",
  "resource_ancestry_path": "site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"
}'
{
  "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"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

تفاصيل العطل المراد إنشاؤه.

​
resource_id
string
required

المعرف الفريد للمورد الذي يواجه العطل.

Example:

"dev_2j4k2l2j3k4l2j3k4"

​
microservice_id
string
required

معرف الخدمة المصغرة التي تبلغ عن العطل.

Example:

"manual-api-entry"

​
type
string
required

فئة بنمط slug للعطل.

Example:

"wan-degradation"

​
severity
enum<string>
required

مستوى خطورة العطل.

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

"HIGH"

​
message
string
required

ملخص موجز وسهل القراءة للعطل.

Example:

"زمن استجابة رابط WAN مرتفع: زمن استجابة الرابط الأساسي (WAN1) مرتفع"

​
cause
string
required

شرح مفصل للسبب المحتمل.

Example:

"تجاوز اختبار زمن الاستجابة 250 مللي ثانية لمدة 5 فحوصات متتالية."

​
resource_ancestry_path
string

اختياري. سلسلة نصية مفصولة بشرطة عمودية | للسياق الهرمي.

Example:

"site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"

Response

كائن العطل الذي تم إنشاؤه حديثًا.

يمثل كائن Fault مشكلة أو حدثًا تم اكتشافه داخل الشبكة.

​
id
string

معرف فريد لكائن العطل، يبدأ بالبادئة flt_.

Example:

"flt_31pkd1t8FvW7qZv0jG2a9kH5mB1"

​
resource_id
string

المعرف الفريد للمورد الذي تعرض للعطل.

Example:

"dev_2j4k2l2j3k4l2j3k4"

​
customer_id
string

المعرف الفريد لحساب العميل الذي ينتمي إليه هذا العطل.

Example:

"cus_1i2j3k4l5m6n7o8p"

​
microservice_id
string

معرف الخدمة المصغرة التي أبلغت عن العطل.

Example:

"wantunnel-monitor"

​
type
string

فئة أو نوع العطل.

Example:

"wantunnel"

​
status
enum<string>

الحالة الحالية للعطل.

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

"unresolved"

​
severity
enum<string>

مستوى خطورة العطل.

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

"CRITICAL"

​
message
string

ملخص موجز وسهل القراءة للعطل.

Example:

"فشل في تجاوز رابط WAN: الرابط الأساسي (WAN1) معطل"

​
cause
string

شرح مفصل للسبب المحتمل للعطل.

Example:

"فشل الاختبار: تجاوز زمن الاستجابة عتبة 500 مللي ثانية"

​
created_at
string<date-time>

الطابع الزمني عند اكتشاف العطل وإنشائه لأول مرة.

Example:

"2025-10-21T12:00:00.000000Z"

​
resolved_at
string<date-time> | null

الطابع الزمني عند حل العطل. يكون فارغًا (Null) إذا كان العطل لا يزال نشطًا.

Example:

null

​
resource_ancestry_path
string | null

سلسلة نصية مفصولة بشرطة عمودية | تمثل الموقع الهرمي للمورد، وتُستخدم لتصفية الأعطال حسب مورد أصل (على سبيل المثال، موقع معين).

Example:

"site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"

​
ttl
integer | null

طابع زمني بنظام Unix يشير إلى متى ستنتهي صلاحية سجل العطل تلقائيًا من قاعدة البيانات.

Example:

1797825595

​
comments
object[]

قائمة بالتعليقات المرتبطة بالعطل، مرتبة من الأقدم إلى الأحدث.