الانتقال إلى المحتوى الرئيسي
POST
/
faults
/
{faultId}
/
comment
إضافة تعليق إلى عطل
curl --request POST \
  --url https://api.altostrat.io/faults/{faultId}/comment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "comment": "أكد مزود خدمة الإنترنت وجود قطع في كابل الألياف البصرية في المنطقة. الوقت المقدر للإصلاح هو 4 ساعات."
}'
{
  "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.

Path Parameters

faultId
string
required

المعرف الفريد للعطل الذي سيُضاف إليه التعليق.

Example:

"flt_31pkd1t8FvW7qZv0jG2a9kH5mB1"

Body

application/json

محتوى التعليق.

comment
string
required

المحتوى النصي للتعليق المراد إضافته.

Maximum length: 2000
Example:

"أكد مزود خدمة الإنترنت وجود قطع في كابل الألياف البصرية في المنطقة. الوقت المقدر للإصلاح هو 4 ساعات."

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[]

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