الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
monitoring
/
wan
/
ping-stats
الحصول على إحصائيات Ping المجمعة
curl --request POST \
  --url https://api.altostrat.io/v1/monitoring/wan/ping-stats \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tunnels": [
    "9f9510bd-a425-4d9d-a7cf-f845a39e26db",
    "a1b2c3d4-e5f6-7890-1234-567890abcdef"
  ],
  "from": "2025-10-29T10:00:00Z",
  "to": "2025-10-29T11:00:00Z",
  "datapoints": 50
}'
{
  "timestamps": [
    1761619200000,
    1761619500000,
    1761619800000
  ],
  "data": [
    {
      "tunnel_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "latency": [
        12.5,
        13.1,
        null,
        12.8
      ],
      "packet_loss": [
        0,
        0,
        100,
        0.1
      ],
      "mdev": [
        1.2,
        1.5,
        null,
        1.3
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Body

application/json
from
string<date-time>
required

بداية الفترة الزمنية.

Example:

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

to
string<date-time>
required

نهاية الفترة الزمنية.

Example:

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

tunnels
string<uuid>[]

مصفوفة من مُعرّفات أنفاق WAN (UUIDs) للاستعلام عنها. إذا تم حذفها، يتم إرجاع تجميع لجميع الأنفاق.

Example:
[
"9f9510bd-a425-4d9d-a7cf-f845a39e26db",
"a1b2c3d4-e5f6-7890-1234-567890abcdef"
]
datapoints
integer
default:100

العدد المطلوب من نقاط البيانات في الاستجابة. سيتم تجميع البيانات لتتناسب مع هذا العدد، بحد أقصى 100.

Example:

50

Response

إحصائيات Ping كسلاسل زمنية للأنفاق المطلوبة.

timestamps
integer[]

مصفوفة من الطوابع الزمنية لنظام يونكس (بالمللي ثانية) المقابلة لكل نقطة بيانات.

Example:
[1761619200000, 1761619500000, 1761619800000]
data
object[]

مصفوفة من سلاسل بيانات الأنفاق.