الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
monitoring
/
arps
البحث في إدخالات ARP
curl --request POST \
  --url https://api.altostrat.io/v1/monitoring/arps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "search": "192.168.1.10",
  "sites": [
    "d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"
  ],
  "page": 1,
  "per_page": 10,
  "sort": "ip_address",
  "order": "asc"
}'
{
  "current_page": 123,
  "data": [
    {
      "id": "0c8526584284b025f3c328904724cf48a1a3848b",
      "mac": "00:1A:2B:3C:4D:5E",
      "ip_address": "192.168.88.254",
      "interface": "bridge",
      "last_seen": "منذ 5 دقائق",
      "group": "<string>",
      "hostname": "my-laptop.local",
      "manufacturer": "Apple, Inc.",
      "site_id": "d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
      "range": "192.168.88.0/24",
      "alias": "الخادم الرئيسي",
      "serial": "<string>"
    }
  ],
  "first_page_url": "<string>",
  "from": 123,
  "last_page": 123,
  "last_page_url": "<string>",
  "links": [
    {
      "url": "<string>",
      "label": "<string>",
      "active": true
    }
  ],
  "next_page_url": "<string>",
  "path": "<string>",
  "per_page": 123,
  "prev_page_url": "<string>",
  "to": 123,
  "total": 123
}

Authorizations

Authorization
string
header
required

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

Body

application/json

مصطلح بحث للتصفية حسب عنوان IP أو عنوان MAC أو اسم المضيف أو الشركة المصنعة.

Example:

"192.168.1.10"

sites
string<uuid>[]

مصفوفة من مُعرّفات المواقع (Site UUIDs) لتضمينها في البحث. إذا تم حذفها، يتم البحث في جميع المواقع التي يمكن الوصول إليها.

Example:
["d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"]
page
integer
default:1

رقم الصفحة لتقسيم النتائج.

per_page
integer
default:10

عدد النتائج التي سيتم إرجاعها لكل صفحة.

sort
enum<string>
default:ip_address

الحقل الذي سيتم فرز النتائج وفقه.

الخيارات المتاحة:
ip_address,
mac_address,
hostname,
manufacturer,
alias,
range
order
enum<string>
default:asc

ترتيب الفرز.

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

Response

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

current_page
integer
data
object[]
first_page_url
string<uri>
from
integer
last_page
integer
last_page_url
string<uri>
next_page_url
string<uri> | null
path
string<uri>
per_page
integer
prev_page_url
string<uri> | null
to
integer
total
integer