Denetçileri Listele

Bir düğümün (node) denetçilerini (supervisor) en yeniden eskiye, sayfalı olarak listeler. Düğüm zorunlu bir query filtresidir; sizin kendi düğümünüz ya da onun altındaki bir düğüm olmalıdır.

Gerekli izin: supervisor:view

İstek

GET /v2/admin/supervisors

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	query	Zorunlu. Denetçileri listelenecek düğüm (24 karakterlik hex kimlik)
name	string	query	Denetçinin adı veya soyadında büyük/küçük harf duyarsız kısmi eşleşme
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/supervisors?node_id=665ae536a6392b75cfd40352&page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "665b372f3a72d7d0791596ba",
      "name": "Jane",
      "surname": "Doe",
      "profile_photo": null,
      "email": "admin@example.com",
      "node_id": "665ae536a6392b75cfd40352",
      "role_id": "665ae79610ce216dbc35c93b",
      "identity_number": "",
      "created_at": "2025-09-05T19:26:16.294Z",
      "updated_at": "2026-10-01T08:00:12.1Z",
      "last_seen_date": "2026-11-08T17:42:03.9Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Denetçiler
data[].id	string	Denetçi kimliği
data[].name	string	Ad. Ayarlanmamışsa boş
data[].surname	string	Soyad. Ayarlanmamışsa boş
data[].profile_photo	string | null	Profil fotoğrafı URL'si
data[].email	string	E-posta adresi
data[].node_id	string	Denetçinin ait olduğu düğüm
data[].role_id	string	Denetçinin rolü
data[].identity_number	string	Kimlik numarası. Ayarlanmamışsa boş
data[].created_at	string	Oluşturulma zamanı (ISO 8601)
data[].updated_at	string	Son güncelleme zamanı (ISO 8601)
data[].last_seen_date	string	Denetçinin en son görüldüğü zaman (ISO 8601)
total	integer	Filtrelere uyan denetçi sayısı
page	integer	Sayfa numarası
per_page	integer	Sayfa başına kayıt

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (eksik ya da hatalı node_id, eksik page veya per_page) — details alanına bakın
400	10001	Düğüm bulunamadı (düğüm domain'i 2)
403	10005	Düğüm, hiyerarşide sizin erişebildiğiniz kısmın dışında (düğüm domain'i 2)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.