الانتقال إلى المحتوى الرئيسي
POST
/
sites
/
{siteId}
/
commands
/
synchronous
تنفيذ أمر متزامن
curl --request POST \
  --url https://api.altostrat.io/sites/{siteId}/commands/synchronous \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "command": "/interface/print",
  "parameters": [
    "=address=8.8.8.8",
    "=count=4"
  ]
}'
[
  {
    ".id": "*1",
    "name": "ether1",
    "type": "ether",
    "mac-address": "00:1A:2B:3C:4D:5E",
    "mtu": 1500,
    "running": true
  },
  {
    ".id": "*2",
    "name": "ether2",
    "type": "ether",
    "mac-address": "00:1A:2B:3C:4D:5F",
    "mtu": 1500,
    "running": false
  }
]

Authorizations

​
Authorization
string
header
required

رمز JWT صادر عن خدمة المصادقة في Altostrat، يحتوي على مطالبات المستخدم والمنظمة.

Path Parameters

​
siteId
string
required

المعرّف الفريد للموقع (جهاز التوجيه).

Body

application/json

أمر RouterOS ومعلماته المطلوب تنفيذها على الموقع المستهدف.

​
command
string
required

مسار أمر واجهة برمجة تطبيقات RouterOS. يجب أن يكون هذا الأمر للقراءة فقط.

Example:

"/interface/print"

​
parameters
string[]

معلمات أمر واجهة برمجة تطبيقات RouterOS، منسقة كمصفوفة من السلاسل النصية. يجب أن تكون كل سلسلة نصية بالتنسيق '=key=value'.

Example:
["=address=8.8.8.8", "=count=4"]

Response

تم تنفيذ الأمر بنجاح. يحتوي الجسم على الاستجابة الخام من واجهة برمجة تطبيقات RouterOS.

الاستجابة الخام من واجهة برمجة تطبيقات RouterOS، والتي تكون عادةً مصفوفة من الكائنات تمثل ناتج الأمر.