قائمة جلسات الاتصال

GET /api/v1/seances

تُعيد قائمة مقسَّمة إلى صفحات بجلسات اتصال وحدات القياس عن بُعد، مع إمكانية تصفيتها حسب وحدة القياس عن بُعد والفترة الزمنية.

معاملات الطلب

telemetry_id integer

معرّف وحدة القياس عن بُعد. معامل اختياري — يضيّق نطاق الاختيار.

fp_start string

الفترة الزمنية (بداية المقطع) بصيغة yyyy-mm-dd. معامل اختياري.

fp_end string

الفترة الزمنية (نهاية المقطع) بصيغة yyyy-mm-dd. معامل اختياري.

page integer

رقم الصفحة.

حقول الاستجابة

السمة	الوصف
`id`	المعرّف (المفتاح الفريد) لجلسة الاتصال في النظام
`telemetry_id`	المعرّف (المفتاح الفريد) لوحدة القياس عن بُعد في النظام
`event_time`	تاريخ ووقت جلسة الاتصال بصيغة UTC
`Evtid`	رمز سبب جلسة الاتصال
`Trycnt`	عدد مرات إعادة المحاولة
`Tryfl`	رمز إعادة المحاولة
`state`	حالة جلسة الاتصال
`Btm`	شحن بطارية وحدة القياس عن بُعد
`Rssi`	مستوى الإشارة (RSSI)
`Bsg`	شحن البطارية المترولوجية
`gettime`	طلب الوقت الحالي من الخادم
`next_session_time`	الوقت المقرّر لجلسة الاتصال التالية
`referenceparameter_seance_status_id`	معرّف حالة جلسة الاتصال في النظام
`duration_session`	مدة جلسة الاتصال
`session_traffic`	حجم حركة البيانات
`millisecond`	المللي ثانية
`data`	مصفوفة البيانات المعادة
`total_pages`	العدد الإجمالي للصفحات في المجموعة المعادة
`current_page`	الصفحة الحالية
`next_page`	الصفحة التالية المتاحة للتحميل، وتكون `null` إذا كانت الصفحة الحالية هي الأخيرة

الطلب

bash

curl -i \
  --header "access-token: *********************" \
  --header "token-type: Bearer" \
  --header "client: **********************" \
  --header "uid: api-user@example.com" \
  --header "Content-Type: application/json" \
  --request GET \
  "https://api.vadsro.eu/api/v1/seances?telemetry_id=1111&fp_start=2021-11-02&fp_end=2021-11-30&page=2"

const res = await fetch(
  'https://api.vadsro.eu/api/v1/seances?telemetry_id=1111&fp_start=2021-11-02&fp_end=2021-11-30&page=2',
  {
    headers: {
      'access-token': '*********************',
      'token-type': 'Bearer',
      client: '**********************',
      uid: 'api-user@example.com',
      'Content-Type': 'application/json',
    },
  },
);
const data = await res.json();

python

import requests

res = requests.get(
    "https://api.vadsro.eu/api/v1/seances",
    params={
        "telemetry_id": 1111,
        "fp_start": "2021-11-02",
        "fp_end": "2021-11-30",
        "page": 2,
    },
    headers={
        "access-token": "*********************",
        "token-type": "Bearer",
        "client": "**********************",
        "uid": "api-user@example.com",
        "Content-Type": "application/json",
    },
)
data = res.json()

req, _ := http.NewRequest("GET", "https://api.vadsro.eu/api/v1/seances?telemetry_id=1111&fp_start=2021-11-02&fp_end=2021-11-30&page=2", nil)
req.Header.Set("access-token", "*********************")
req.Header.Set("token-type", "Bearer")
req.Header.Set("client", "**********************")
req.Header.Set("uid", "api-user@example.com")
req.Header.Set("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

php

$ch = curl_init("https://api.vadsro.eu/api/v1/seances?telemetry_id=1111&fp_start=2021-11-02&fp_end=2021-11-30&page=2");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "access-token: *********************",
    "token-type: Bearer",
    "client: **********************",
    "uid: api-user@example.com",
    "Content-Type: application/json",
]);
$data = json_decode(curl_exec($ch), true);

الاستجابة

json

{
  "data": [
    {
      "id": 303481,
      "telemetry_id": 1111,
      "event_time": 1636202160,
      "Evtid": null,
      "Trycnt": null,
      "Tryfl": null,
      "state": 0,
      "Btm": 3900,
      "Rssi": 23,
      "Bsg": null,
      "gettime": true,
      "next_session_time": 1636204200,
      "referenceparameter_seance_status_id": 99,
      "duration_session": null,
      "session_traffic": null,
      "millisecond": null
    }
  ],
  "total_pages": 2,
  "current_page": 1,
  "next_page": 2
}

آخر تحديث في 8 أغسطس 2026

هل كانت هذه الصفحة مفيدة؟