الانتقال إلى المحتوى الرئيسي
GET
/
audit-logs
عرض قائمة بأحداث سجل التدقيق
curl --request GET \
  --url https://api.altostrat.io/audit-logs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "log_id": "log_2zqrA8B3C4d5E6f7g8h9I0jKlMn",
      "organization_id": "org_xWl6uERh4pBpJxhA",
      "workspace_id": "ws_sz4e50hmqKgjxwiYsK",
      "user_id": "auth0|9b6efd7459f548c8bb542fe81568791f",
      "name": "سارة أحمد",
      "email": "jane.doe@altostrat.io",
      "session_id": "sess_a1b2c3d4e5f6a7b8",
      "event_time": "2025-10-29T12:26:01.123Z",
      "method": "PUT",
      "endpoint": "/api/v1/projects/proj_A7Bkj29s/settings",
      "status_code": 200,
      "status_code_type": "2xx",
      "ip_address": "188.45.21.109",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
      "frontend_page": "/projects/proj_A7Bkj29s/settings/general",
      "request_payload": {
        "name": "مشروعي الرائع المحدث",
        "visibility": "private"
      },
      "response_payload": {
        "status": "success",
        "message": "تم تحديث إعدادات المشروع بنجاح."
      },
      "request_id": "req_abc123xyz789-test-01",
      "ttl": 1766862361
    }
  ],
  "pagination": {
    "count": 25,
    "limit": 25,
    "cursor": "eyJQSyI6eyJTIjoiT1JH...In0sInNrIjp7IlMiOiJMT0cj...In19",
    "has_more": true
  },
  "filters": {
    "start_date": "2025-10-01",
    "http_verb": "PUT",
    "limit": 25
  },
  "query_info": {
    "scanned_count": 150,
    "query_time_seconds": 0.082
  },
  "warnings": [
    "قد تكون النتائج غير مكتملة عند استخدام search_term بسبب قيود الاستعلام. استخدم عوامل تصفية مفهرسة وأكثر تحديدًا للحصول على نتائج شاملة."
  ],
  "context": {
    "requesting_user_id": "auth0|5a4b3c2d1e0f9g8h7i6j5k4l",
    "requesting_workspace_id": "ws_abc123def456ghi789",
    "organization_id": "org_xWl6uERh4pBpJxhA",
    "timestamp": "2025-10-29T14:05:12.345Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
start_date
string<date>

تاريخ بدء نطاق الاستعلام، شامل. التنسيق: YYYY-MM-DD.

Example:

"2025-10-01"

​
end_date
string<date>

تاريخ انتهاء نطاق الاستعلام، شامل. يجب أن يكون مساوياً لـ start_date أو بعده. التنسيق: YYYY-MM-DD.

Example:

"2025-10-31"

​
user_id
string

تصفية الأحداث لمستخدم معين حسب معرّفه الفريد.

Example:

"auth0|9b6efd7459f548c8bb542fe81568791f"

​
workspace_id
string

تصفية الأحداث لمساحة عمل معينة حسب معرّفها الفريد.

Example:

"ws_sz4e50hmqKgjxwiYsK"

​
http_verb
string

التصفية حسب طريقة HTTP (مثل POST، DELETE). لاستبعاد طريقة ما، أضف قبلها علامة تعجب (مثل !GET).

Example:

"POST"

​
status_code
integer

التصفية حسب رمز حالة HTTP معين.

Required range: 100 <= x <= 599
Example:

404

​
endpoint
string

التصفية حسب مسار نقطة نهاية API. هذا بحث بالبادئة (على سبيل المثال، /api/v1/users سيطابق /api/v1/users/usr_123).

Example:

"/api/v1/projects"

​
search_term
string

مصطلح بحث حر. سيتم البحث في حقول مثل نقطة النهاية، واسم المستخدم، والبريد الإلكتروني، وعنوان IP، وحمولات الطلب/الاستجابة. ملاحظة: قد يكون استخدام search_term أقل أداءً من استخدام عوامل التصفية المفهرسة.

Example:

"فشل تسجيل دخول المستخدم"

​
ip_address
string<ipv4>

تصفية الأحداث الصادرة من عنوان IP معين.

Example:

"198.51.100.14"

​
cursor
string

سلسلة نصية مبهمة تحدد نقطة البداية للصفحة التالية من النتائج. احصل على هذه القيمة من حقل pagination.cursor في استجابة سابقة.

Example:

"eyJQSyI6eyJTIjoiT1JH...In0sInNrIjp7IlMiOiJMT0cj...In19"

​
limit
integer
default:25

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

Required range: 1 <= x <= 100
Example:

50

​
sort_order
enum<string>
default:desc

ترتيب فرز النتائج. desc للأحدث أولاً، asc للأقدم أولاً.

الخيارات المتاحة:
asc,
desc
Example:

"desc"

Response

قائمة مقسمة إلى صفحات لأحداث سجل التدقيق المطابقة للاستعلام.

​
data
object[]
​
pagination
object
​
filters
object

عوامل التصفية التي تم تطبيقها على هذا الاستعلام.

Example:
{
  "start_date": "2025-10-01",
  "http_verb": "PUT",
  "limit": 25
}
​
query_info
object

بيانات وصفية حول تنفيذ الاستعلام.

​
warnings
string[]

قائمة بالتحذيرات حول الاستعلام، مثل عند استخدام عوامل تصفية قد تكون غير مكتملة.

Example:
[
  "قد تكون النتائج غير مكتملة عند استخدام search_term بسبب قيود الاستعلام. استخدم عوامل تصفية مفهرسة وأكثر تحديدًا للحصول على نتائج شاملة."
]
​
context
object

معلومات سياقية حول طلب API نفسه.