الانتقال إلى المحتوى الرئيسي
POST
/
sites
/
{siteId}
/
jobs
إنشاء مهمة لموقع
curl --request POST \
  --url https://api.altostrat.io/sites/{siteId}/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: text/plain' \
  --header 'X-Description: <x-description>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '/ip address add address=192.168.99.1/24 interface=ether2'
{
  "id": "8b8b2e5e-1a19-4a19-8b19-1e1919191919",
  "token": "2jP5kLqWnZ",
  "site_id": "9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a",
  "idempotency_key": "7c7c1e4e-1918-4918-8a18-1e1818181818",
  "description": "إضافة قاعدة جدار حماية جديدة لشبكة الضيوف",
  "express_execute": false,
  "needs_acknowledgement": true,
  "should_backup": true,
  "associated_backup": "9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a/1667888400.rsc",
  "started_at": "2025-10-29T12:05:10Z",
  "completed_at": null,
  "failed_at": null,
  "created_at": "2025-10-29T12:00:00Z",
  "log_url": "logs?group=sites&streams=9a9a...&start=...&end=...&filter={$.message=*2jP5kLqWnZ*}",
  "script": "/ip firewall filter add chain=forward action=accept src-address-list=guests"
}

Authorizations

​
Authorization
string
header
required

توثيق الطلبات من خلال توفير رمز ويب JSON (JWT) في ترويسة Authorization. مثال: Authorization: Bearer <YOUR_JWT>

Headers

​
X-Idempotency-Key
string<uuid>
required

معرف UUID فريد يوفره العميل لضمان معالجة الطلب مرة واحدة فقط.

​
X-Description
string
required

وصف سهل القراءة لغرض المهمة.

Required string length: 3 - 100
​
X-Needs-Ack
boolean

(الافتراضي: true) اضبط القيمة على false إذا كان يجب اعتبار المهمة مكتملة بمجرد إرسالها إلى الجهاز، دون انتظار استجابة نجاح/فشل.

​
X-Backup
boolean

(الافتراضي: false) اضبط القيمة على true لإنشاء نسخة احتياطية من تكوين الموقع تلقائيًا قبل تنفيذ هذه المهمة.

​
X-Express-Execute
boolean

(الافتراضي: false) اضبط القيمة على true لمحاولة تشغيل تسجيل وصول فوري للجهاز لتنفيذ المهمة بشكل أسرع.

Path Parameters

​
siteId
string<uuid>
required

معرف UUID للموقع المستهدف.

Body

text/plain · string

نص RouterOS البرمجي الخام الذي سيتم تنفيذه على الجهاز.

The body is of type string.

Example:

"/ip address add address=192.168.99.1/24 interface=ether2"

Response

تم إنشاء المهمة بنجاح.

أمر أو نص برمجي غير متزامن ليتم تنفيذه على موقع.

​
id
string<uuid>

المعرف الفريد (UUID) للمهمة.

Example:

"8b8b2e5e-1a19-4a19-8b19-1e1919191919"

​
token
string

رمز قصير وفريد وسهل القراءة للمهمة، يُستخدم غالبًا في تصفية السجلات.

Example:

"2jP5kLqWnZ"

​
site_id
string<uuid>

معرف الموقع الذي تستهدفه هذه المهمة.

Example:

"9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a"

​
idempotency_key
string<uuid>

مفتاح فريد يوفره العميل لمنع إنشاء مهام مكررة.

Example:

"7c7c1e4e-1918-4918-8a18-1e1818181818"

​
description
string

وصف سهل القراءة لغرض المهمة.

Example:

"إضافة قاعدة جدار حماية جديدة لشبكة الضيوف"

​
express_execute
boolean

إذا كانت القيمة true، فستحاول المنصة تشغيل تسجيل وصول فوري من الجهاز لتنفيذ هذه المهمة في وقت أسرع.

Example:

false

​
needs_acknowledgement
boolean

إذا كانت القيمة true، تتطلب المهمة إشعارًا صريحًا بالنجاح/الفشل من الجهاز ليتم تمييزها على أنها مكتملة.

Example:

true

​
should_backup
boolean

إذا كانت القيمة true، فقد تم إنشاء نسخة احتياطية من التكوين تلقائيًا قبل وضع هذه المهمة في قائمة الانتظار.

Example:

true

​
associated_backup
string | null

مسار ملف النسخ الاحتياطي للتكوين المرتبط بهذه المهمة، إذا تم إنشاؤه.

Example:

"9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a/1667888400.rsc"

​
started_at
string<date-time> | null

الطابع الزمني عندما بدأ الجهاز في تنفيذ المهمة.

Example:

"2025-10-29T12:05:10Z"

​
completed_at
string<date-time> | null

الطابع الزمني عندما أبلغ الجهاز عن إتمام المهمة بنجاح.

Example:

null

​
failed_at
string<date-time> | null

الطابع الزمني عندما أبلغ الجهاز عن فشل أثناء تنفيذ المهمة.

Example:

null

​
created_at
string<date-time>

الطابع الزمني عند إنشاء المهمة.

Example:

"2025-10-29T12:00:00Z"

​
log_url
string

عنوان URL نسبي لواجهة مستخدم Altostrat SDX لعرض السجلات المتعلقة بتنفيذ هذه المهمة.

Example:

"logs?group=sites&streams=9a9a...&start=...&end=...&filter={$.message=*2jP5kLqWnZ*}"

​
script
string

حمولة نص RouterOS البرمجي الخام للمهمة.

Example:

"/ip firewall filter add chain=forward action=accept src-address-list=guests"